Copyright 1979 by Eastern House Software 
All Rights Reserved 
Copyright Notes 


This manual and the object code (contained on floppy disk) is serial numbered and protected by a 
legitimate copyright. No part of this manual may be copied or reproduced without the express 
written permission of the copyright owner, Eastern House Software. You may make a backup 
copy of the diskette in order to protect your copy of this software. It is though a Federal crime to 
make a copy of the manual or floppy disk for use by anyone other than the individual who 
purchased this software or the individual a company purchased the software for. 


Thus, you are in violation of Federal Copyright Laws if you do one of the following: 


e Make a copy of the manual. 

e If you allow someone else to use your copy (or backups) of the object media (diskette) 
while you retain a copy or are using a copy. 

e Ifyou, your company, or others purchase one or more copies and more individuals 
simultaneously use this software than the number purchased. 

e If you allow someone else to do the copying of this material, you will be considered as a 
party to the infringement. 


A reward will be provided for anyone supplying information which leads to the prosecution of 
parties who violate this copyright. 


We do not presume that you are or will violate copyright laws. Most users do not. Some though 
do, and may not realize the consequences for violation of this Federal Law. Penalties and fines 
can be quite severe for both individuals and companies who infringe this copyright. 


Most importantly, software houses like the one which wrote this software have incurred a 
tremendous investment that cannot be fully recovered if current illegal copying continues. Also, 
updates and program maintenance will have to be terminated if the return on investment is not 
sufficient. 


Finally, an expressed appreciation is given to the purchaser of this software. I hope that you find 
it a valuable and worthwhile investment. 


If you encounter any problems, contact us at: 


Eastern House Software 


Carl Moser Don Earnhardt 
3239 Linda Drive or 2130 Nettlebrook Dr. 
Winston-Salem, N. C. 27106 Winston-Salem, N. C. 27106 
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Notes on this Electronic Version of the Manual 


This manual was created from a poorly photocopied manual for Eastern House Software Apple 
Macro Assembler/Editor (MAE) I obtained in the early 1980s whilst at College. Being an 
impoverished student I could not afford the Software nor the hardware (Apple 2) to run it on but 
I was fortunate to have friends who lent me their systems and I spent many happy hours over the 
years learning 6502 Assembly Language Programming and Hacking the hardware. 


After graduation I planned to get an Apple 2 and continue this work but life interfered with this 
plan. I did purchase a Clone Apple I+ motherboard and started to populate it with parts but 
again work, family ... 


So this manual sat on my shelf for many years and with that un-populated Clone motherboard 
and a real Apple II+ acquired in the early 90s silently taunted me. 


Nearing retirement has rekindled my fascination with these early 8-bit Hackable Computers. 
Investigating Apple II emulation with software such as AppleWin I discovered that while a Disk 
Image of the MAE Software from 1980 exists on the ftp.apple.asimov.net archive no copy of this 
Manual has been uploaded and while manuals for the PET and Atari platforms exist, this manual 
is specific to the Apple II platform. 


I scanned the photocopy of the Manual I had and cleaned it up as best I could and have uploaded 
it to the Internet Archive for preservation. 


But I wanted a better copy for my own use. Using the ABBY Fine Reader Optical Character 
Recognition (OCR) Software I created a text version of the Manual and imported it into 
Microsoft Word 2013 re-formatting it while attempting to preserve the content and look and feel 
of the original manual making only a few spelling and punctuation corrections. 


The sample Programs included in the Manual posed a problem as the OCR Software struggled 
due to the Dot-Matrix printout, small font size and poor quality of the photocopy. I spent a lot of 
time attempting to make the Sample Programs correct but eventually used the aforementioned 
Disk Image to Assemble the Sample Programs and the resulting output to get a much more 
accurate listing. 


I would like to take this opportunity to thank the original Authors, Carl Moser, J.R. Hall of 
Eastern House Software and Don Earnhardt, who ported MAE to the Apple II. An interview with 
Carl and J.R. was conducted by the Antic PodCast October 17", 2016 and is available on the 
Antic Website and also here on the Internet Archive. 


This manual likely still contains errors, but hopefully will be of use to the Vintage Computer 
Community. When in doubt the scanned manual should be consulted. 


Bruce B. Gordon 
Ottawa, ON 
<first> @ <last>+"s"dot"ca" 


APPLE MAE — Copyright 1980 by Eastern House Software 


v012 Apple II Macro Assembler/Editor (MAE) 24 Jan 2024 


Contents 
ig VOR EO Tees es ccc gee ste atea uaa ieee decena uses aeitie IRacestmdeleyetoca tensa naceettn deaeacsnceceebus aaceu eanneeedenaady 1 
2 _ Files Contained, Om tie: DIS Ke tte cocsciaectaiccrtencune disses 2 ode ds sce acdescueyacoad enti nautdeteceresinlemencsecenewecs a 
So Tet Editon (ED) Fe gies ac sscinassvnaanuse ss einitared gna vaass i teeda nies canter eda daase ta iarvneaiuee eae laaes 3 
Bi. MA OMMBATIS aise Voscd sede ncacisgetnce sa odes suesaciedonde ts cccuadetacesetaaacnacaendenceidteuanedineansedesoencatunlonietedines eo 
ins, Entry Deletons( hatiee Of Vem ssscctesexscetersteccie ed caoee heeded deessvedaesateceuaa isaac’ 8 
4. (‘Assembler ( ASS IM) Pe Atte oss codscuausccoiasmiess ccataivanesuansscttenscniedinens sieinasacacacndnctouxssaeddeatveeodacannes 9 
Be. SONGS: WANE TIIGIIN 9 TAK cee eacccessddnncoeieesauaeseecsasonss ees dacede ade ass paces naceee eee ene eae 9 
ib. Teabel: Pile (or S yeas UAMMIG ) gacscsincinscchnesadeecseal caeuansansecnaseaaceanasniornisyoaciensnoieswaaseactvasateteed one 16 
Ge PASSE UIUD UN cates Gs at ere etna hee yede sesces deen lecica oases neato eae eaea ead eee deca 16 
d. Creating a relocatable object file (Via ) OU).........ccccccsseseescsseseescssessescseesecsessesecsesseecseeaeees 17 
Cu.  WMaCrOS talc sgeceiet esa eee eae eee ees 18 
He Momma ASSO Yo scaicecs asada ces tueaeirntessce dil ccnssci dn aecdate ne iWoadaundaacaeuacebuceiacbedetveleaneciadenieudeeese 20 
We, - TIMMS ACEI POST Vora sacs ea sens baled co ctacasdanepeaaca etna eataie ois bases eee eee 22 
he . Detamlt Patanieters Ory Gite yO Leo MN ees et acest catecacts aac estenssctedeavancescolvebomncnngveeieteieasec 23 
5, Relocate the Relocating Modder isccgesccswcactscustecesetecieareetaicdeneearesiennesednasndiaieeeeeee 23 
Ce. REE i aia ates eta cetiencccdr unos snet neaaeceeccaaduccpieks ce dqunectnedoeceteetadenteacthucestesucaipelaaseteeuadeeteeates 24 
7 -oelting Search-and. Replace Comings. sycc)cycindesccevedi era ceeccsrats cy inde leusendddesapedaeesGaeeineece 2 
Bl COMM ANN ag cee ec c es beeen xeeea nee evita nessa eta dhe codec eye sated ncee easy eaecdnieeeeeevaeee gene 2) 
Mie. Ptr aA ss het tesa pinta essen esteemed cated ee eed oe cena 27 
8. Control Codes (Serial Device)...........cceccccccccccccesesssssecececeeeensssssecececeesesessaaaeeeeeesesesesssaeeeeeeeens 27 
9. Using MARF's Built-in Software UART scisccccecccsoteascecsesastctenteis cessicesccnaasbeeestavicdastassczevaseeneess 28 
LLG aN 21602) Fk Ree ee mR on ee aR Rn Ce Penne CRE TEMPOS RTE ney enero emery ate 29 
Be VED) Beene aia codices acae sadn ccdanedes ae eaceniccesstceseeaucndagecusceeeaseedeanasicae eauupddegdecedaeeeiuaaseens 29 
Ms IN ae aa waa caren tealeena, deactucsarcentnsaasen. dad iados anectugocceuntacaecoppsatteess caceteccestustanaces 31 
Li, Getting Started with IMAL sicssccpeccetac cotctesceeesSpeveceeedsseeccteckeedelai douse beste dacecaueeeess Gaedeialdeetaccenes Ee 
12, “The MAE, Simplified Text Processor S UP) sss.cspscsixs caters tsananscsadastsyadaseevashsnsdonsesndenesiveszensconint 34 
a. Howto Use the STP Word Process oociicecescccscesacddsccawieassaenccdecasvcnsd cauucdde dentocesberedcveasenices 38 
Ms AIS IN top fe acca en eeecantonacee tccaeeeniecnadcn ded canem. accent cuaeeane 2 ageensdadecapeteeeso-eesantese.aaapncecooencnees 39 
U3. Special Ota s eiciccsentis ences ceed eu stacscbick cneptbicen sd inca cxdcea cade ceacke teased veeneh acct beeacecee Sock seep icete tac beadt 39 
a. Converting Eastern House ASSM/TED Files to MAE Files .00... eee eeeeeeeeeeseeeneeeeeeenees 39 
bb; Editing Basic: Programs: with MIA Be icccec cise ciesice vaste scdececcetacceiccbecchacicedseteeideaeloedideacedieeaanceeds 39 
c. Converting MAE Files To and From Other Assemblers ...............cecseceeeseeceeeeeeeeeeeeeseeeeeaes 40 
ly: IM SCe lame OUis INOUE ac cevcdtisnecsvastoecanesia ere iaanadedsastened eeteandasasieveeeessadaasaavunntva Snesdeauseesia eaanaincs 40 
Ae be ate oh, gl Bi) BBO). 010 eee ane ev gene eer Swe Ree ve ene Es 4] 
15. How tov Confers for Prieta c2i255.2scteanctle cit dealestoicietes cede caac cede ciancdedasaudice ses vecadeaeccdlecestinne’ 42 
DG Ere ekg Me MA else Bes cone tencepee: accurndacte enc m actin ctaeicine a.aseueededecepenc deco veteniesea agcumncndeconeaeaues 43 
Bice VAR Pr tin sis cehescctecddeciecadhiatacecdaceeclaitoecdtesc aged Sdabadeddleatactatecusddandeced ied Geanlieexeateonses 43 
b. MAE Supplied Nonstandard Printer Driver... eee eseceseceseeeeeeeeaeecnneceseeesneeeneeenaeens 48 
c. MAE Menu Listing (Applesoft BASIC) i.ccccccccssicccdeseccedacenscediassancdudesteacdentondeceaeebieeassceels 48 
UZ, ;EATGOE © OUGS: «sse2,cacceagadasctaandecovepaiansnetwancensintndssensandesedied ideinaasesenndacentacassanssnededaaananceeepuaasaetauaew: 49 


Apple MAE — Copyright 1980 by Eastern House Software 


Page 1 


1. Introduction 

This Macro Assembler (ASSM) and Text Editor (TED) resides simultaneously in approximately 
11K bytes of memory ($5000-$7C80). The collective assembler and text editor is referred to as 
MAE. MAE was designed to work with the 48K Apple II or Apple II Plus microcomputer and 
Disk II. 


As mentioned, the MAE object code occupies just over 11K of memory. In addition to this, 
sufficient memory must be allocated for the text file and label file (symbol table). Approximately 
8K is sufficient memory for the text file for small programs or larger programs if assembled from 
disk. If an executable object code file is to be stored in memory during assembly, sufficient 
memory must be provided for that also. On cold start entry ($5000), MAE will set the file 
boundaries as follows: 


e Text File $3000 - $4FFC 
e Label File $1800 - $2FFC 
e Relocatable Object Buffer $7800 


($7800 is a buffer provided internally to MAE) 


These boundaries leave memory for other language programs at $0800 - $17FC and at $7C80 - 
$95FC. The label file and text file that MAE generates is position independent and may be 
located practically anywhere in RAM memory. The object code file location is dependent on the 
Beginning of Assembly (.BA ) and the Move Code (.MC) pseudo operands (pseudo ops.) 


Fear not the accidental reset! The MAE contains reset protection which executes a warm start 
when the reset key is pressed. This prevents any loss of data if an accidental reset occurs. 
Additionally, if you exit the MAE to the monitor or to BASIC, the reset key will cause a return 
to that particular language. In order to return to the MAE, perform a warm start (see Part 11). 
The previous text file should remain intact. 


MAE was designed such that records in the label file and text file are variable in length and 
directly dependent on the number of characters to be stored. This results in more efficient 
utilization of memory. Some unique features of MAE are: 


e Coexists with Apple Integer and/or Applesoft BASIC Languages. 

e Supports Macro, Conditional, and Interactive Assembly. 

e Labels up to 31 characters in length. 

e Auto line numbering for ease of text entry. 

e Creates both executable code in memory and relocatable object code on disk. 
e Manuscript feature for composing letters and other text. 

e Loading and Storing via the Apple Disk IL. 

e Supports various printer arrangements. 

e String search and replace capability, plus other powerful editing commands. 
e Capability to send command strings to Apple Disk II. 
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MAE uses a prompter character: ")". This parentheses character is used to indicate that MAE is 
ready to accept commands. Command mnemonics referenced in this document are printed with 
the prompter (example ") BR"). When inputting a command, you should not type ")" proceeding 
the mnemonic. 


Initial entry (or cold start) to MAE is at address $5000. If the break command, ") BR", is 
executed, one may reenter MAE at $5003. Initial entry provides the following default 
parameters: 


e Format set 
e Manuscript clear 
e Auto line numbering off 
e Text file and Label file clear 


MAE was designed to coexist with Apple BASIC. This was accomplished by preserving 
BASIC’s zero page variables. Thus, on cold start entry, MAE copies $98 - $FF of zero page to a 
save area ($7698 - $76PF). On all exits (via '") BR", ") RU" or ")US"), MAE restores these 
variables. On warm start entry, MAE swaps zero page with the save area. MAE also uses a 
number of absolute variables at $7700-$77FF. 


You should protect MAE from BASIC by setting the BASIC variable HIMEM ($73, $74) to 
point to Just below MAE and its text and label files. For example, to protect memory above 
$1800, enter $00 at location $73 and $18 at location $74. 


This software has been extensively tested and is believed to be entirely reliable. It would be 
foolish to guarantee a program of this size and complexity to be free of errors. Therefore, we 
assume no responsibility for the failure of this software. 


MAE is protected by a Copyright. This material may not be copied, reproduced, stored in a 
retrieval system, or otherwise duplicated without the written permission of the owner, Carl 
Moser. The purchaser may however make copies of the diskette for his own individual use for 
backup purpose. The purchase of this software does not convey any license to manufacture, 
modify and/or copy this product in any manner. 
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2. Files Contained on the Diskette 
The supplied diskette contains the following files: 


Filename Description 

MAE . EXE MAE object code 

RELOC. EXE Relocating Loader object code 

RELOC. REL Relocating Loader relocatable code 

MAE . NOT * Some notes on MAE 

WORDP. EXE Word Processor Program 

WORDP.INS * Word Processor Instructions File and example of raw text 
MLMACROS.MLIB  *_ File of some Machine Language Macros 
SWEET16.MLIB * File of SWEET16 Macros 

UART .CTL * Example program control file 

UART .MOL * Example program modules 

UART .MO2 (UART Driver) 

UART .MO3 

PARL .OUT .EXE Parallel printer driver 
TEXTOUT.SOURCE * Program to convert MAE files to text files 
TEXTOUT . EXE Textfile program 


* Indicates source files in MAE format. 


3. Text Editor (TED) Features 

The TED occupies approximately one-half the total memory space of this software. The purpose 
of the TED is to setup and maintain the source file by interacting with the user via various 
commands. 


When inputting to the TED, the user has available the full capabilities of the built-in Apple II 
screen editor. 


When listing to the CRT or printer, the user has control of the output via the following keys: 


Control+S Temporarily halt outputting and await input of one of the following keys. 
Control+Z Return to ")" level. 

Control+O Continue processing but suppress output except for errors. 

Control+Q Continue outputting after control S. 

Control+C Exit to Apple monitor. (5003G to re-enter MAE) 

Control+B Exit to BASIC. (Call 20483 to re-enter MAE) 


a. Commands 

The TED provides 27 command functions. Each command mnemonic must begin immediately 
after the prompter (")"). When entered, a command is not executed until a carriage return is 
given. Although a command mnemonic such as ") PR" may be several non-space characters in 
length, MAE only considers the first two. For example, ") PR", ") PRI", ") PRINT", and 

") PRETTY" will all be interpreted as the print command. 
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Some commands can be entered with various parameters. For example, ") PRINT 10 200" 
will print out the text in the text file with line numbers between 10 and 200. One must separate 
the mnemonic and the parameters from one another by at least one space. Do not use commas. 


A disk filename may be specified in some of the following commands. Wherever "fi 1e" is 
given as a command parameter, its format is as follows: 


Dn "name" 
where: N is the disk Drive/Slot number (default - 16 for drive 1, slot 6 - i.e. D16) 
"name" is the file name (enclosed in double quotes) 


Examples are: DL6 "MAE.NOT" 
D26 "RELOC.REL" 
"DOS SUPPORT" 


A description of each command follows: 
JASSEMBLE "file" w 


If file is specified, load the file into text area and if no file specified, then assemble 
contents of text area. 


If w= "LIST" then generate a listing. If w= "NOLIST" or not entered then an errors 
only output will be generated. 


AUTO x 


Begin auto line numbering mode with next user entered line number. x specifies the 
increment to be added to each line number. 


You may exit auto line numbering by entering "//" immediately following the prompted 
line number. 


) BASIC 

Restore zero page and go to BASIC. 
) BREAK 

Restore zero page and go to Monitor. 
) CLEAR 

Clear text file. 
COPY Xx y z 


Copy lines y thru Z in the text file to just after line number xX. The copied lines will all 
have line numbers equal xX. At completion, there will be two copies of this data, one at x 
and the original at y. 
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)DC "command" 


Pass disk commands to Apple DOS. Any DOS command that can normally be entered as 
a direct command may be passed. 


Examples: Output catalogis: | )DC "CATALOG" 
Delete file TEST is: )DC "DELETE TEST" 


)Dc "@filename" 


Apple MAE generates two binary files for each source file saved on the disk. These files 
are represented in the catalog as "Fi lename" and "fi 1ename*". The file with the 
trailing asterisk in its name is used by MAE to calculate the length of the actual source 
file during loading. MAE uses this as a safeguard to prevent you from loading a file 
larger than the boundaries allocated for the text file. If the file is larger than allocated 
memory, MAE will not load it but instead issue a ! OF error. 


To summarize, the )DC "@filename" command is used when it is desired to delete 
both entries in the directory (including the filename* file). 


)DELETE x y 


Delete entries in the text file between line numbers X and y. If only X is entered, only that 
line is deleted. 


JEDIT t S1 t S2 t or JEDIT n 

String search and replace, or interline edit. See Part 7. 
)FIND t S1t 

String search. See Part 7. 
) FORMAT w n 


Format the text file (where w = "SET") or clear the format feature (where w = "CLEAR"). 
Format set tabulates the text file when outputted. 


This lines up the various source statement fields. 


nN specifies the number of characters per label (max. = 31). This is used to tabulate the 
listing. 


)GET "file" y 


Get file from disk and store in the text buffer. If y is not entered, store at start of text 
buffer. If y is a line number, enter following specified line number. If y = "APPEND" 
then enter following current contents of text file. 


Examples: )GET "MEMTEST" 
)GET D16 "CRTDVR" 1000 
)GET 027 "UART" APPEND 
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)HARD w X 


Format for hard copy listing. This feature is designed to work with 66 line pages and 
leaves margin at top and bottom along with page number. ".)HA SET" turns this feature 
on, ")HA CLEAR" turns this feature off. x is the starting page number. ".)HA PAGE" 
advances to top of next page. 


Each time ")HA SET" is entered, MAE resets its internal line counter to 0. Thus, you 

must manually adjust the paper in the printer so MAE and the printer are synced. 
)LABELS w 

Print out the entire contents of the label file if w= "ALL" or w is not entered. Print only 


fixed (external) labels if w = "FIXED". Print only internal or program labels if w = 
"PROGRAM". 


)MANUSCRIPT w 


If w= "SET", line numbers are not outputted when executing the ") PR" command. If w = 
"CLEAR", line numbers are outputted when the ") PR" command is executed. Assembly 
output ignores the ")MA" command. If manuscript is to be generated using MAE, 
manuscript should be set and format clear: ")MA SET", ")FO CLEAR". Since the TED 
considers a blank line a deletion, you may insert a blank line by entering a line with a 
single period. When printed, a blank line will be output. 


MOVE X y Z 


Move lines y thru Z in the text file to just after line number x. The moved lines will all 
have line numbers equal to xX. The original lines y thru Z are deleted. 


NUMBER x y 


Renumber the text file starting at line X in the text file and expanding by constant y. For 
example, to renumber the entire text file by 10, enter")NU O 10". 


JOUTPUT "file" 


Create a relocatable object file on disk. This command uses the 256 byte relocatable 
buffer that can be reallocated via the ) SET command. 


PASS "file" 


Execute second pass of assembly. The first pass must be previously performed. If a 
filename is entered in the )PASS command, then the text file is loaded before executing 
the second pass, else ) PASS will assume the file is in the text area. 


)PRINT X y 


Print the text file data between line number X and y on the CRT. If only X is entered, 
only that line is printed. If neither x nor y are entered, the entire file is printed. 
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) PUT 


) RUN 


) SET 


"file" x y 


Put text file between lines x and y to disk. If x and y are not entered, the entire text file 
will be put to disk. (Hint: use this to save your source code) 


label 


Run (execute) a previously assembled program. If a symbolic label is entered, the label 
file is searched for the starting-address. The called program should contain an RTS 
instruction as the last executable instruction. 


ts te Is le bs 


If no parameters are given, the text file, label file, and relocatable buffer boundaries 
(addresses indicating text file start (tS), end (te), label file start (1S), end (1e@), and 
relocatable buffer start (S)) will be output on the first line. On the second line the output 
consists of the present end of data in the text and label file. This command is commonly 
used to determine how much memory is remaining in the text file. If you are inputting 
hex digits for these addresses, precede each with a '$' character. 


If parameters are entered, the first two are text file start (tS) and end (te) addresses, 
then the label file start (1S) and end (1e) addresses, and finally the relocatable buffer 
start address (bs). 


Caution should be used not to set either the text file or label file boundaries to $800. 
This conflicts with BASIC. 


)TI w n (See Part 9) 


Assign terminal input (keyboard) as Apple if w= "APPLE", or serial device if w = 
"SERIAL". Both input and output will be assigned to the serial device if w = 
"TERMINAL". If entered, n is the number of pad bits to be sent on occurrence of carriage 
return. 


When )TI SERIAL or )TI TERMINAL is entered, you must type S on the serial 
keyboard so MAE can determine the baud rate of the device. Permissible baud rates are 
110, 300, 600, 1200, 2400, 4800, 7200, and 9600. After you type S, press the return key. 
If MAE receives a valid carriage return character, control is then transferred to the serial 
device. If a valid carriage return is not received, control will remain with the Apple. 


)TO wn m(See also Part 9) 


Assign terminal output (CRT or printer) as: Apple screen if Ww = "APPLE", or printer (thru 
MAE printer driver) if w= "PRINTER". If w= "SERIAL" then output will be directed 
thru the MAE software UART driver (See Part 9). If w= ''ALL" then output will be 
directed thru both the printer vector and the software UART. 


If you are using a standard Apple printer interface, then instead enter")DC "PR#n"" to 
turn on your printer (see Part 15). 
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If you do not have a standard Apple II printer, you may insert a JSR to your printer 
driver at $791B. Currently this is configured for use with the popular Heath H14 printer. 


If w= "SERIAL" or "ALL", then n is the baud rate code and m is the number of pad bits 
on occurrence of carriage return. The baud rate code (nN) is as follows: 


baud rate 
110 
300 
600 
1200 
2400 
4800 
7200 
9600 


NYDUFWNrY OCS 


)USER 


Restore zero page and go to location $0000. You must have entered a JMF instruction at 
that address. Note that BASIC defaults $0000 to point to its warm start entry. 


b. Entry/Deletion/Change of Text 

Source is entered in the text file by entering a line number (0-9999) followed by the text to be 
entered. The line number string can be one to n digits in length. If the string is greater than 4 
digits in length, only the right-most 4 are considered. Text may be entered in any order but will 
be inserted in the text file in numerical order. This provides for assembling, printing, and 
recording in numerical order. Any entry consisting of a line number with no text or just spaces 
results in a deletion of any entry in the text file with the same line number. If text is entered and a 
corresponding line number already exists in the text file, the text with the corresponding number 
is deleted and the entered text is inserted. 


To delete the entire file, use the ") CL" command. 


To delete a range of lines, use the ") DE" command. To edit an existing line or lines having 
similar characteristics, use the ") ED" command. 


To alter an existing line, use the ") ED" command form 2. 


To find a string, use the ") FI" command. To move or copy lines use the ")MO" or ") CO" 
commands. 


To insert a blank line, enter a line with just a period (.). 


Text may be entered more easily by use of the auto line numbering feature (via the ") AU" 
command). Any ")AU xX" command where x does not equal 0 puts the TED in the auto line 
number mode on the next entry of a line number. To exit from this mode, type ") //". 


When entering source for the assembler, one need not space over to line up the various fields. 
Labels are entered immediately after the line number. Separate each source field with one or 
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more spaces. If the format feature is set (see the "}) FO" command), the TED will automatically 
line up the fields. Note: If a space is entered before the label, the TED will line up the label in the 
next field. This should result in an assembler error when assembled. Commands, mnemonics, 
and pseudo ops may be entered as upper case or lower case characters. Labels in the program 
may be entered as upper or lower case characters but a label entered as upper case will be unique 
to the same label entered as lower case. 


4. Assembler (ASSM) Features 

The ASSM scans the source program in the text file. This requires at least 2 passes (or scans). On 
the first pass, the ASSM generates a label file (or symbol table) and outputs any errors that may 
occur. On the second pass, the ASSM creates an optional listing. 


A third pass (via the ")OU" command), may be performed in order to generate a relocatable 
object file of the program in the text file. This file is recorded on disk and may be relocated at the 
user’s discretion practically anywhere in memory. 


a. Source Statement Syntax 
Each source statement consists of 5 fields as described below: 


)line number label mnemonic operand comment 
label: 
The first character of a label may be formed from the following characters: 
@ A thru Z[ ] 


While the remaining characters which form the label may be constructed from the 
above characters and the following characters: 


./Othru9:;<>? 
The label is always entered immediately after the line number. 
mnemonic (or Pseudo Op): 


The mnemonic or pseudo op is separated from the label by one or more spaces 
and consists either of a standard 6502 mnemonic from Table A, a pseudo op from 
Table B, or a macro name. 


operand: 


The operand is separated from the mnemonic or pseudo op by one or more spaces 
and may consist of a label expression from Table C and symbols which indicate 
the desired addressing mode from Table D. 


comment: 


The comment is separated from the operand field by one or more spaces and is 
free format. A comment field begins one or more spaces past the mnemonic or 
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pseudo op if the nature of such does not require an operand field. A free format 
comment field may be entered if a semicolon (;) immediately follows the line 
number. 


Note: It is permissible to have a line with only a label. 


This is commonly done to assign two or more labels to the same address. If the 
line has only a label or a label with a comment, then the label may be any length, 
up to 79 characters, regardless of the label length set with the ") FORMAT" 
command. 


TABLE A - 6502 Mnemonics 


ADC | BMI | CLD | DEY | LDA | PHP | SBC | NOP 
AND | BNE | CLI | EOR | LDX | PLA | SEC | TAX 
ASL | BPL | CMP | INC | LDY | PLP | SED | TAY 
BCC | BRK | CPX | INK | LSR | ROL | SET | TSX 
BCS | BVC | CPY | INY | CLV | ROR | STA | TXA 
BEQ | BVS | DEC | JMP | ORA | RTI | SIX | TXS 
BIT | CLC | DEX | JSR | PHA | RTS | STY | TYA 


(For a description of each mnemonic consult the 6502 Software Manual) 


TABLE B - Pseudo Ops 


.A7 


Store ASCII strings in Apple format (bit 7 set). The input format is .A7 ‘this string is in 
Apple format’, refer to the . BY pseudo op for further details. 


.BA label exp. 


. BY 


Begin assembly at the address calculated from the label expression. This address must be 
defined on the first pass or an error will result and the assembly will halt. 


Note: When .BA, .MC, and .OS are used in a file, they must be used in this order. 


Store bytes of data. Each hex, decimal, or binary byte must be separated by at least one 
space. An ASCII string may be entered by beginning and ending with apostrophes (’). 
Example: 


-BY 00 'ABCD' 47 69 'Z' $FC %1101 


In order to insert consecutive blank spaces in an ASCII string using either a .A7 or .BY 
pseudo op, you must enter two apostrophes and a single space prior to the string. 
Example: 


.A7 "-'----ABC' (""=" represents a space character). 
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CE 


Continue assembly if errors other than !07, !04, or !17 occur. All error messages will be 
printed. 


CT 


Designate current contents of text buffer as a control file. Only one control file may exist 
during each assembly. Designation as a control file allows the use of . FI pseudo ops to 
link other files for the assembly process. 


Note: Only one . EN pseudo op is allowed in each assembly and if . CT is used, 
the . EN must be at the end of that file. Thus, files referenced via . FI must not 
have an . EN pseudo op. 


label .DE label exp. 


Assign the address calculated from the label expression to the label. Designate as external 
and put in the label file. An error will result if the label is omitted. 


label .DI label .exp. 


Assign the address calculated from the label expression to the label. Designate as internal 
and put in the label file. An error will result if the label is omitted. 


.DS label exp. 


Define a block of storage. For example, if label exp. equated to 4, then ASSM will skip 
over 4 bytes. Note: The initial contents of the block of storage is undefined. 


»EC 


Suppress output of macro generated object code on the source listing. This is the default 
state. See Part 4E. 


EJ 
Eject to top of next page if )HA SET was previously entered. 
. EN 
Indicates the end of the source program. 
.ES 
Output macro generated object code on source listing. See Part 4E. 
.FI file 
Assemble the specified fi 1e before continuing with statement following . FI. 


Note: The . FI pseudo op is allowed only in the control file (that designated with . CT). 
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.IN label 


»LC 


ES 


Outputs "?" followed with a space and then accepts up to 4 hex digits. These hex digits 
will be assigned to label and stored in the label file. 


Input will only occur on the first pass of assembly. The label used must be symbolic and 
should be defined similar to the following example: 


BEGIN.ADDR 
.PR "ENTER ASSEMBLY START" 
.IN BEGIN.ADDR 


One should avoid using .DE, .DI, or SET to define the label as these constructs reassign 
their specified value on each pass. 


If the label specified in the . IN pseudo op has not been defined when the . IN is 
encountered, Mae will not accept input, for example: 


» IN VALUE 
VALUE 


In this case, MAE will not accept input. To correct this, simply move the label to or in 
front of the . IN pseudo op. 


Clear the list option so that the assembly terminates printing the source listing after the 
. LC on pass 2. 


Set the list option so that the assembly begins printing out the source listing after the . LS on 


pass 2. 


.MC label exp. 


.MD 


»ME 


.MG 


When storing object code, move code to the address calculated from the label expression 
but assemble in relation to that specified by the . BA pseudo op. An undefined address 
results in an immediate assembly halt. 


Macro definition. See Part 4E. 


Macro end of definition. See Part 4E. 


. MG declares the entire contents of the text file as Macro Global. When assembling from 
disk, all following files will be loaded into the text file area following the file with the 
. MG. Thus, even though there can be many modules loaded and assembled, the macro 
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OC 


.OS 


»PR 


»RC 


»RS 


SI 


global file is "locked" into the text file area providing its macro definitions for use by all 
subsequent files. 


Clear the object store option so that object code after .OC is not stored in memory. This 
is the default option. 


Set the object store option so that object code after the .OS is stored in memory on pass 
2. 


"text" 


Output the text that is enclosed in quotes when the . PR is encountered. MAE 
automatically issues a carriage return immediately before outputting the text. The text 
will be output only during the first pass of the assembly. 


Provide directive to the relocating loader to stop resolving address information in the 
object code per relocation requirements and store code at the pre-relocated address. This 
condition remains in effect until an . RS pseudo op is encountered. 


Provide directive to the relocating loader to resolve address information in the object 
code per relocation, and store the code at the proper relocated address. This is the default 
condition. 


label exp. 


Store the address calculated from the label expression in the next two memory locations. 
Consider this address as being an external address. Note: If a label is assigned to the . SE, 
it will be considered as internal. 


label exp. 


Store the address calculated from the label expression in the next two memory locations. 
Consider this address as being an internal address. 
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Table C - Label Expressions 


A label expression must not consist of embedded spaces and is constructed from the 
following: 


Symbolic Labels: 


One to 31 characters consisting of the ASCII characters as previously 
defined. The maximum number of characters is set by the "}) FORMAT 
SET n" command where n = the maximum number allowed. The default 
maximum is 10 characters per label. 


Non-Symbolic Labels: 


Decimal, hex, or binary values may be entered. If no special symbol 
proceeds the numerals then the ASSM assumes decimal (example: 147). 
If "$" precedes, then hex is assumed (example: $F3). If "%" precedes, 
then binary is assumed (example: 11001). Leading zeros need not be 
entered. If the decimal or hex string is greater than 4 digits, only the 
rightmost 4 are considered. If the binary string is greater than 8, only the 


rightmost 8 are considered. 
Program Counter: 


To indicate the current location of the program counter, use the symbol 


Wow 


Arithmetic Operators: 


These are used to separate the above label expression elements. Two 
operators are recognized: 


"+" for addition 
"_" for subtraction. 


Examples of some valid label expressions follow: 


LDA #%1101 ;LOAD IMMEDIATE $0D 

STA *TEMP+$01 ;STORE AT BYTE FOLLOWING TEMP 

LDA $471E36 ;LOAD FROM LOCATION $1636 

JMP LOOP+C-$461 ;JMP TO CALCULATED ADDRESS 

BNE =+8 ;BRANCH TO CURRENT PC PLUS 8 BYTES 


One special label expression is A, as in "ASL A". The letter A followed with a space in 
the operand field indicates accumulator addressing mode. Thus "LDA A" is an error 
condition since this addressing mode is not valid for the LDA mnemonic. 


"ASL A+0" does not result in accumulator addressing but instead references a memory 
location. 
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Table D - Addressing Mode Formats 


Immediate: 
LDA #%1101 ; BINARY 
LDA #$F3 ; HEX 
LDA #MASK ; SYMBOLIC 
LDA #'A ; ASCII 


LDA #H,label exp. ;HI PART OF THE ADDRESS OF THE LABEL 
LDA #L,label exp. ;LO PART OF THE ADDRESS OF THE LABEL 


Absolute: 

LDA label exp. 
Zero Page: 

LDA *label exp. ;THE ASTERISK (*) INDICATES ZERO PAGE 
Absolute Indexed: 


LDA label exp. ,Xx 
LDA label exp. ,yY 


Zero Page Indexed: 


LDA *label exp.,xX 
LDA *label exp.,Y 


Indexed Indirect: 
LDA Clabel exp. ,xX) 
Indirect Indexed: 


LDA (label exp.),Y 
Indirect: 


JMP (label exp.) 


Accumulator: 
ASL A ;LETTER A FOLLOWED WITH A SPACE INDICATES 
; ACCUMULATOR ADDRESSING MODE 
Implied: 
TAX ;OPERAND FIELD IGNORED 
CLC 
Relative: 


BEQ label exp. 
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b. Label File (or Symbol Table) 

A label file is constructed by the assembler and may be outputted at the end of assembly (if a 

. LC pseudo op was not encountered) or via the ) LA command. The output consists of the 
symbolic label and its hex address. Via the .) LA command, the user may select which type of 
labels to be output. )LA FIXED outputs all program and internal labels, and )LA ALL outputs 
all labels. When a relocatable object file la generated (via .) OU command), any instruction which 
referenced an internal label or a label expression which consisted of at least one internal label 
will be tagged with special information within the relocatable object file. The relocating loader 
uses this information to determine if an address needs to be resolved when the program is moved 
to another part of memory. 


Conversely, instructions which referenced an external label or a label expression consisting of all 
external references will not be altered by the relocating loader. 


At the end of the label file the number of errors which occurred and program break in the 
assembly will be outputted in the following format: //XxXxx, yyyy , ZZZZ 


Where XXxXx is the number of errors found in decimal representation, yyyy is last address in 
relation to . BA, and ZZZzZ is the last address in relation to .MC. 


c. Assembling 
Source for a large program may be divided into modules, entered into the text file one at a time 
and recorded on disk using ) PU. 


These modules can be linked together during assembly via a control file. If used, the control file 
must be the first file to be assembled. This file must be in the text buffer when the ) AS 
command is issued, or its name must be specified in the ) AS command (example: ) AS 

"MEM. TEST"). Files are linked together via the . FI pseudo op. For example, to assemble 3 
files named X.MO1, Y.MO02, and Z.MO03, we need to generate a control file say M.CTL (note for 
convenience we use the convention of tagging CTL on the end of any name which references a 
control file while its modules are tagged Mxx). The file M.CTL may contain the following: 


.CT 
-FI D16 "X.M0O1" 
-FI D16 "Y.M0O2" 
-FI D16 "Z.M03" 
.EN 


Now, when the control file is assembled, MAE is told to go assemble the files in the order 
specified. 


At assembly, the assembler can load and assemble each module until the entire program has been 
assembled. This will require two passes for a complete assembly. When the end of a pass is 
encountered, MAE will output the message END MAE PASS1. If for some reason you terminate 
the assembly on the second pass, you may restart at the beginning of the second pass using the 

) PASS command. 
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d. Creating a relocatable object file (via ) OU) 

In order to create a relocatable object file, the programmer should identify those labels whose 
addresses are fixed and should not be altered by the relocating loader. This is done via the . DE 
pseudo op. Non-symbolic labels (example: $0169) are also considered as being external (or 
fixed). All other labels (including those defined via the . DI pseudo op) are considered as 
internal. Addresses associated with internal labels can be altered by an offset when the program 
is loaded via the relocating loader. 


Also, the . SB stores a two byte external address and the . ST stores a two byte internal address. 
Similarly the relocating loader will alter the internal address and not the external address. 


An example of an external address would be the calls to Apple monitor routines (eg. JSR 
$FDED) or any location whose address remains the same no matter where the program is 
located. Other external addresses would be locations in zero page that the Apple monitor or DOS 
uses. An example using an internal address would be when you want to store the address of a 
number of subroutines in a table. An example illustrating how MAE stores command mnemonics 
and associated processing routine is as follows: 


.BY 'CO' ;COPY COMMAND 
.SI COPY.MOD ;COPY MODULE 
.BY 'MO' ;MOVE COMMAND 
.SI MOVE.MOD ;MOVE MODULE 
.BY 'PR' ;PRINT COMMAND 


-SI PRINT .MOD ;PRINT MODULE 


Expressions consisting of internal and external labels will be combined and considered an 
internal address. For example, suppose the label BUFFER was contained in your program as 
BUFFER .DS 80. Then references consisting of the label BUFFER and the external reference 
+3, such as LDA BUFFER+3, would be combined and considered .as an internal reference. 
Thus the relocating loader will alter references to BUFFER+3 when you relocate the program. A 
label expression consisting entirely of external labels will be combined and considered as 
external. 


The relocating loader can relocate your program in 3 segments: Zero page variables (internal 
addresses in range $00-$FF), absolute variables (internal addresses in range $0400-$1FFF), 
and program body (references in range $2000-$FFFF). To generate a relocatable object file, 
first partition your program into internal and external references. Remember, external references 
are those locations that are fixed while internal references are those locations which can be 
altered by the relocating loader. 


Start assigning zero page references at location $0000, absolute variable locations at $0400, 
and begin assembly of the program at $2000. (The program will not be relocated properly 
unless it is assembled using a .BA $2000 statement.) Next assemble the program via ) AS, and 
then issue the ) OUT command to generate a relocatable object file. 


Now, we have the relocatable object code on disk. To load this object code back into memory, 
first load the relocating loader. The relocating loader is contained on the diskette with the name 
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RELOC. EXE. Execution begins at $800 if in the monitor or CALL 2048 if in BASIC. The 
relocating loader will request the following: 


1. FILENAME? Name of the file containing the relocatable object code. (Enter 
with quotes around name.) 

2. Z=PG OFFSET? Address to begin assignment of zero page internal references. 

3. ABS OFFSET? Address to begin assignment of absolute internal references. 

4, PGM EXE OFFSET? Address the program is to execute. 

5. PGM STORE OFFSET? Address to store the program object code. 


When the file has been relocated in memory, it can be saved on disk (via BSAVE) as an 
executable file, which may be reloaded without using the relocating loader. 


As an example, let’s assume we want to relocate a program named UART to execute at location 
$3000, but store the object code at $1000, and start the zero page variables at $0060, and the 
absolute variables at $4000. We would respond to the relocating loader as follows: 


FILENAME? D16 "UART.REL" File name 

Z-PG OFFSET? 60 Assign start of zero page var. 
ABS OFFSET? 4000 Assign start of absolute var. 
PGM EXE OFFSET? 3000 Program body start 

PGM STORE OFFSET? 1000 Store of code start 

LOAD MAP 


R. L. outputs a load map 
FILENAME? Enter just carriage returns to exit the 
Relocating Loader 
e. Macros 


MAE provides a macro capability. A macro is essentially a facility in which one line of source 
code can represent a function consisting of many instruction sequences. For example, the 6502 
instruction set does not have an instruction to increment a double byte memory location. A 
macro could be written to perform this operation and represented as INCD (VALUE.1). This 
macro would appear in your assembly language listing in the mnemonic field similar to the 
following: 


BNE SKIP 
NOP 


INCD (VALUE. 1) ; LNCREMENT DOUBLE 
LDA TEMP 


Before a macro can be used, it must be defined in order for ASSM to process it. A macro is 
defined via the .MD (macro definition) pseudo op. Its form is: 


!!!label .MD CLI L2 ... Ln) 
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Where label is the name of the macro ("! ! !"" must precede the label), and"L1 L2 ... Ln" are 
dummy variables used for replacement with the expansion variables. These variables should be 
separated using spaces, do not use commas. 


To terminate the definition of a macro, use the .ME (macro end pseudo op). 


For example, the definition of the INCD (increment double byte) macro could be as follows: 


!!'TINCD .MD- (LOC) ; INCREMENT DOUBLE 
INC LOC 
BNE SKIP 
INC LOC+1 

SKIP »ME 


This is a possible definition for INCD. The assembler will not produce object code until there is 
a call for expansion. 


Note: A call for expansion occurs when you enter the macro name along with its parameters in 
the mnemonic field as INCD CTEMP) or INCD CCOUNT) or INCD CCOUNT+2) or 
any other labels or expressions you may choose. 


Note: In the expansion of INCD, code is not being generated which increments the variable 
LOC but instead increments the associated variable in the call for expansion. 


If you tried to expand INCD as described above more than once, you will get a !06 error 
message. This is a duplicate label error and it would result because of the label SKIP occurring in 
the first expansion and again in the second expansion. 


There is a way to get around this and it has to do with making the label SKIP appear unique with 
each expansion. This is accomplished by rewriting the INCD macro as follows: 


1! !INCD -MD (LOC) ; INCREMENT DOUBLE 
INC LOC 
BNE ...SKIP 
INC LOC+1 
...SKIP = .ME 
The only difference is". . . SKIP" is substituted for "SKIP". What the ASSM does is to assign 
each macro expansion a unique macro sequence number (2**16 maximum macros in each file). 
If the label begins with". . ." then ASSM will assign the macro sequence number to the label. 


Thus, since each expansion of this macro gets a unique sequence number, the labels will be 
unique and the ! 06 error will not occur. 


If the label '". . . SKIP" also occurred in another macro definition, no ! 06 error will occur in its 
expansion if they are not nested. If you nest macros (i.e. one macro expands another), you may 
get a ! 06 error if each definition uses the ". . . SKIP" label. The reason this may occur is that as 
one macro expands another in a nest, they each get sequentially assigned macro sequence 
numbers. As the macros work out of the nest, the macro sequence numbers are decremented until 
the top of the nest. Then as further macros are expanded, the sequence numbers are again 
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incremented. The end result is that it is possible for a nested macro to have the same sequence 
number as one not nested or one at a different level in another nest. Therefore, if you nest 
macros, it is suggested that you use different labels in each macro definition. 


Some further notes on macros are: 


1. The macro definition must occur before the expansion. 

The macro definition must occur in each file that references it. Each file is assigned a 
unique file sequence number (2**16 maximum files in each assembly) which is assigned 
to each macro name. Thus the same macro can appear in more than one file without 
causing a ! 06 error. If a macro with the same name is defined twice in the same file, 
then the ! 06 error will occur. 

3. Macros may be nested up to 32 levels. This is a limitation because there is only so much 
memory left for use in the stack. 

4. If amacro has more than one parameter, the parameters should be separated using spaces, 
do not use commas. 

5. The number of dummy parameters in the macro definition must match exactly the 
number of parameters in the call for expansion. 

6. The dummy parameters in the macro definition must be symbolic labels. The parameters 
in the expansion may be symbolic or non-symbolic label expressions. 

7. Ifthe .ES pseudo op is entered, object code generated by the macro expansion will be 
output in the source listing. Also, comment lines within the macro definition will be 
output as blank lines during expansion. Conversely, if . EC was entered, only the line 
which contained the macro call will be output in the source listing. 

8. A macro name may not be the same as a 6502 mnemonic, pseudo op, or conditional 
assembly operator. 


f. Conditional Assembly 

MAE also provides a conditional assembly facility to conditionally direct the assembler to 
assemble certain portions of your program and not other portions. For example, assume you have 
written a CRT controller program which can provide either a 40, 64, or 80 character per line 
display. Instead of having to keep 3 different copies of the program, you could use the ASSM 
conditional assembly feature to assemble code concerned with one of the character densities. 


Before we continue with this example, let’s describe the Conditional Assembly operators: 


IFE label exp. If the label expression equates to a zero 
quantity, then assemble to end of control 
block. 

IFN label exp. If the label expression equates to a quantity 


not equal to zero, then assemble to end of 
control block. 

IFF label exp. If the label expression equates to a positive 
quantity or 0000, then assemble to end of 
control block. 
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IFM label exp. If the label expression equates to a negative 

(minus) quantity, then assembly to end of 

control block. 

Three asterisks in the mnemonic field 

indicates the end of the control block. 

SET label=label exp. _ Set the previously defined label to the 
quantity calculated from the label expression. 


Note: All label expressions are equated using 16 - bit precision arithmetic. 


Going back to the CRT controller software example, a possible arrangement of the program is as 
follows: 


CHAR.LINE .DE 40 


IFE CHAR.LINE-40 ;CODE FOLLOWS FOR 40 CHAR. PER LINE 
IFE CHAR.LINE-64 ;CODE FOLLOWS FOR 64 CHAR. PER LINE 
IFE CHAR.LINE-80 ;CODE FOLLOWS FOR 80 CHAR. PER LINE 


le ste ale 
2 78 


;COMMON CODE FOR ALL 


Shown is the arrangement which would assemble code associated with 40 characters per line 
since CHAR. LINE is defined as equal 40. If you wanted to assemble for 80 characters, simply 
define CHAR.LINE as equal 80. 


Conditional assembly can also be incorporated within macro definitions. A very powerful use of 
conditional assembly, is the ability to cause a macro to be fully expanded on the first reference 
and only partly expanded on subsequent references. For example, assume you wrote a macro to 
do a sort on some data. It could be defined as follows: 


EXPAND -DE O 
1! 1 SORT -MD 
IFN EXPAND 
JSR SORT.CALL ;CALL SORT 


le ale ale 
2 78 FE 


IFE EXPAND 
JSR SORT.CALL 
JMP ...ABC 


; SORT CODE FOLLOWS 
SORT. CALL 
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RTS 


- ABC SET EXPAND=1 


le ste ale 
2 98 FF 


»ME 


In this example, EXPAND is initially set to 0. When the macro is expanded for the first time, 
EXPAND equals O and the code at SORT. CALL will be assembled along with a JSR to and a 
JMP around the sort subroutine. Also, the first expansion sets EXPAND to 1. On each succeeding 
expansion, only a JSR instruction will be assembled since EXPAND equals 1. Using conditional 
assembly in this example resulted in more efficient memory utilization over an equivalent macro 
expansion without conditional assembly. 


g. Interactive Assembly 
Interactive assembly is a new concept in which the assembler can be instructed to print messages 
and/or accept keyboard input during the first pass of the assembly. 


Interactive assembly makes use of two pseudo ops: 


.PR__ to print messages 
.IN to accept keyboard input 


An example of the use of interactive assembly is as follows: 


.PR “INPUT START OF ASSEMBLY" 
ADDR 

.IN ADDR 

.BA ADDR 


Note that in this example, the assembler will request entry of an address to be assigned to ADDR, 
and then begins assembly at that address. Interactive assembly could be used in our CRT 
controller example as follows: 


.PR "INPUT WHICH CONTROLLER (40, 64, 80)" 
CHAR.LINE .IN  CHAR.LINE 


Note: In the above example, the label CHAR. LINE was defined on the same line as the 
. IN this is perfectly OK and it eliminates the need to define CHAR. LINE ona 
separate line using the . DE pseudo op. You might say that it kills two birds with 
one stone. 


There are many applications for interactive assembly but those possibilities are left for the users 
of MAE. 


Note: Never specify a label as the operand in the . IN pseudo op that has been defined by the 
. DE, .DI, or SET pseudo ops. The reason is that these pseudo ops initialize the address 
assigned to associated labels on both assembly passes while all other labels are initialized 
only on the first pass. Since the . IN pseudo op accepts input on the first pass only, usage 
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of labels defined by .DE, .DI, and SET will cause different label values on pass | versus 
pass 2. 


h. Default Parameters on entry to ASSM 

e Does not store object code in memory (otherwise use .OS) 

e Begins assembly at $0800 (otherwise use . BA) 

e Halts assembly on errors (otherwise use . CE) 

e Stores object code beginning at $0800 unless a . BA or .MC is encountered and if .OS 
is present. 

e Object code generated by macros does not appear on the assembly listing (i.e. default is 
. EC) 


5. Relocating the Relocating Loader 
A relocatable object file of the relocating loader is contained on the diskette with the name 
RELOC.REL. 


To relocate the relocating loader, load the executable copy (RELOC. EXE) and begin execution. 
When FILE NAME? is output, enter "RELOC.REL". Then enter 0 for Z-PG OFFSET? and 0 
for ABS OFFSET?. Finally, enter the address of the location you want the relocating loader to 

execute and reside for PGM EXE OFFSET?, and PGM STORE OFFSET?. 


When the relocator completes its task, you may save an executable copy on disk using the Apple 
monitor. Just remember, execution begins at the address specified for the PGM EXE OFFSET, 
not $0800 as for the executable copy supplied (RELOC. EXE). 
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6. Error Codes 

An error message of the form "!xx AT LINE yyyy" where xx is the error code and yyyy is 
the line number will be outputted if an error occurs. Sometimes an error message will output an 
invalid line number. This occurs when the error is on a non-existent line such as an illegal 
command input. 


The following is a list of error codes not specifically related to macros: 


Error Description 


Code 
1B . EN in non .CT file when .CT file exists. 
1A . EN missing in . CT designated file. 
19 Found .FI innon .CT file. 
18 
17 Checksum error on disk load. 
16 
15 Syntax error in ) ED command. 
14 
13 Multiple .CT assignment. 
12 Command syntax error or out of range error. 
11 Missing parameter in ) NU command. 


10 Overflow in line # renumbering. CAUTION: You should properly renumber 
the text file for proper command operation. 

OF Overflow in text file - line not inserted. 

OE Overflow in label file - label not inserted 

OD MAE expected hex characters, found none. 

OC Illegal character in label. 


OB Unimplemented addressing mode. 

OA Error in or no operand. 

09 Found illegal character in decimal string. 
08 Undefined label (may be illegal label). 
07 . EN pseudo op missing. 


06 Duplicate label. 
05 Label missing in .DE or .DI pseudo op. 


04 . BA or .MC operand undefined. 

03 Illegal pseudo op. 

02 Illegal mnemonic or undefined macro. 
01 Branch out of range. 

00 Not a zero page address. 

ED Error in command input. 
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The following is a list of error codes that are specifically related to macros and conditional 


assembly: 


Error Description 


Code 


27 
2E, 
2D 
2C 
2B 
2A 
29 
28 
21 
26 
25 
24 
23 
22 
21 
20 


Overflow in file sequence count (2**16 max.) 
Overflow in number of macros (2**16 max.) 


.ME without associated .HD 
Non-symbolic label In SET pseudo op. 
Illegal nested definition. 


Macro definition overlaps file boundary. 

Duplicate macro definition. 

Quantity parameters mismatch or illegal characters. 
Too many nested macros (32 max.) 

Macro definition not complete at . EN 

Conditional suppress set at . EN 

Macro in expand state at . EN 

Attempted expansion before definition. 


7. String Search and Replace Commands 

a. Edit Command 

A powerful string search and replace, and line edit capability is provided via the ) EDIT 
command to easily make changes in the text file. Use form | to string search and replace, and 
form 2 to edit a particular line. 


Form | 


JEDIT tS1tS2t %d * x y 


or 


JEDIT tS1tS2t %d # x y 


Where: t is anon-numeric, non-space terminator 


S1_ is the string to search for 

S2_ is the string to replace $1 

d is the don't care character. Precede with % character to change the don't 
care character, else the don't care character will be % by default. 
indicates to interact with user via subcommands before replacing S1 

# indicates to alter but provide no printout 
Note: No * or # indicates to alter and provide printout. 

X line number start in text file 

Y — line number end in text file 


Asterisk (*) prompter subcommands: 
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alter field accordingly 

delete entire line 

move to next field - don't alter current 
skip line - don't alter 

exit ) ED command 

enter form 2 


% 


0 
9999 


Defaults: 


KxKXaQaQ NXNZOU D> 


If no * or t entered then print all lines altered. 


For example, to replace all occurrences of the label LOOP with the label START between lines 


100 and 600, enter: 
JEDIT /LOOP/START/ 100 600 
If you want to delete a reference to LOOP, enter a null string replacement as follows: 
JED /LOOP// 
If you want to delete all references to LOOPO1, LOOPO2, etc., enter: 
JED /LOOP%%// 
To simply delete all occurrences of LOOP, enter: 
JEDIT /LOOP// 100 600 
To do the same thing as above but not display changes on the screen, enter: 
JED /LOOP// # 100 600 


The slash ("/") was used in the above examples as the terminator but any non-numeric character 
may be used. 


Suppose, for example, there are some occurrences of the label BUFFER that you wish to change 
to CRT/BUFFER, some you wish to delete (the entire line), and some that you wish to 
extensively edit. This requires a conditional replacement capability with you as a decision maker. 
To do this, enter: 


JED &BUFFER&CRT/BUFFERS * 
(Note that the string terminator & is used because / is actually a part of the string.) 


Now, each time MAE's edit command encounters the string BUFFER, the line will be printed on 
the screen and an asterisk (*) prompter will appear awaiting your entry of one of the 
subcommands (A, D, M, S, X or 2) described above. For example, to replace BUFFER with 
CRT/BUFFER, press "A". To delete the entire line, press "D", to extensively edit the line, press 
"2", etc. When you have made your decision for the current line, the next occurrence of BUFFER 
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will be displayed. This continues until the end of the text file or until you enter the "X" 
subcommand. 


At the end of the ) EDIT operation, the number of occurrences of the string will be output as 
//XXXX_ where XXxxX is a decimal quantity. 


Form 2 
JEDIT n 
Where: n is the line number (0-9999) of the line to be edited. 


After executing this command, the cursor will be positioned at the beginning of the line. The 
usual Apple screen editing escape characters may be used to change the line of text. When the 
return key is pressed, MAE will insert the corrected text into the text file. 


b. Find Command 
If you want to just find certain occurrences of a particular string, use the ) FIND command. Its 
form is: 


)FIND tSlt # x y 
Where: t, S1, #, x, and y are as defined in the ) EDIT command. 
For example, ) FIND /LDA/ will output all occurrences of the string LDA in the text file. 


At the end of the ) FIND operation, the number of occurrences of the string will be output as 
//XXXxX where XXXX is a decimal quantity. 


A unique use of this command is to count the number of characters in the text file (excluding line 
numbers). The form for this is: ) FIND /%/# 


8. Control Codes (Serial Device) 

ASCII characters whose hex values are between hex 00 and 20 are normally non-printing 
characters. With a few exceptions, these characters will be output in the following manner: C, 
where C is the associated printable character if hex 40 was added to its value. For example, 
ASCTI 03 will be output as C, and 18 as X, etc. 


In addition, some of these control codes have special functions in MAE. 
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Control codes which have special functions are: 


Code Description 
Null (hex 00) 
Restore zero page and go to BASIC 
Restore zero page and go to Monitor 
Bell 
Backspace (delete previously entered char.) 
Horizontal tab to next 8-th char, position 
Line feed 
Carriage return 
Continue processing but no output 
* Continue after stop via break key 
Delete entire line altered 
Restore zero page and jump to location $0000. 
(you may reenter at $5003) 
Terminate processing and go to ")" level 
* Escape character 
= Non-printing control character. 


<KOOZUYUHIHAAWSES 
* + © *& * 


* oN 


9. Using MAE's Built-in Software VART 
Note: This is an optional feature of MAE and need not be incorporated. 


If you want to connect an 80 column device (such as an external CRT terminal or TTY) to your 
Apple because the 40 column screen seems "cluttered", you can use MAE's built-in software 
UART driver. This software UART is also useful if you want to "remote" the Apple and access 
via a terminal and modem. All that is required is a parallel port card, you don't have to purchase 
a special serial I/O card for this application. 


Practically any serial device may be connected and controlled by this software. This software 
UART converts bytes to serial format and inputs and/or outputs using just 2 bits of a parallel 
port. The data format consists of one start, 8 data, and 2 stop bits. Via appropriate commands, the 
user can specify the baud rate and also the number of pad bits on carriage return. 


We have found that many RS232 devices can be connected directly to a TTL level parallel port 
without level conditioning circuitry. But if you provide RS232 or other conditioning circuitry, 
you should not invert the signals as they are in their positive true state. 


The commands )TI and )TO are provided to direct MAE to input or output thru this software 
UART, and to specify baud rate and pad bits. 


Examples: )TO SERIAL na direct output thru UART transmitter 
)TI SERIAL n m input from UART receiver 
)TI TERMINAL n Mm direct all input and output thru software UART 


Note: )TI SERIAL and )TI TERMINAL will "lock out" the Apple keyboard. To revert 
back to the Apple keyboard, type )TI APPLE on the external terminal keyboard. 
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The software UART is shipped un-configured. To activate this software you must configure it 
for your system by supplying appropriate addresses and bit positions as follows: 


Addr. Obj. Code 


10. 


a. 
#1 


#2 


#3 


7276 
7279 
727B 
727D 


7285 
7288 
728E 
7291 
72B9 
72BC 


7344 
7347 
7349 
734B 
734D 


AD 
29 
09 
80 


AD 
29 
AD 
29 
AD 
29 


AD 
29 
90 
09 
8D 


Examples 


TED Examples 


XX 
XX 
XX 
XX 


XX 
XX 
XX 
XX 
XX 
XX 


XX 
XX 
02 
XX 
XX 


XX 


XX 


XX 


XX 


XX 


XX 


XX 


Source 


;LF PIA THEN INITIALIZE DIRECTION REGISTER 
;ELSE JUST NOP THIS PART 
LDA PORT.DIR ;GET FROM DIRECTION REGISTER 
AND #XxX ;LNITIALIZE BIT FOR INPUT 
ORA #yy ; INITIALIZE BIT FOR OUTPUT 
STA PORT.DIR ;STORE IN DIRECTION REGISTER 
;GET SERIAL INPUT FROM PARALLEL PORT 
; CSAME CODE BUT THREE DIFFERENT LOCATIONS) 
LDA PORT.DATA ;GET FROM PORT 


AND #Zz ;MASK OUT ALL EXCEPT INPUT BIT 
LDA PORT.DATA ;GET FROM PORT 
AND #Zz ;MASK OUT ALL EXCEPT INPUT BIT 
LDA PORT.DATA ;GET FROM PORT 
AND #Zz ;MASK OUT ALL EXCEPT INPUT BIT 


;PUT SERIAL OUTPUT TO PARALLEL PORT 
LDA PORT.DATA ;GET FROM PORT 


AND #ww ;DEFAULT TO OUTPUT ZERO BIT 
BCC SKP ;BRANCH IF TO OUTPUT ZERO BIT 
ORA #vv ;ELSE OUTPUT A ONE BIT 


SKP STA PORT.DATA ;PUT TO PORT 


Illustrate ways to load MAE and begin execution at the cold start: 


BLOAD MAE.EXE or BRUN MAE. EXE 


CALL 20480 

Illustrate entry of text: 

)AUTO 10 

)1000 ;THIS IS A TEST 
1010 LOOP LDA VALUE,Y 
1020 NOP 

1030 END.PGM .EN 

1040// 


Notes: enter"//" to exit; uses auto line numbering 


Illustrate listing of text: 


) PRINT 

1000 ;THIS IS A TEST 
1010 LOOP LDA VALUE, Y 
1020 NOP 

1030 END.PGM .EN 
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#4 


#5 


#6 


#7 


#8 


#9 


#10 


#11 


#12 


#13 


#14 


#15 


if 

Put file to disk (drive 2, slot 6) with name TEST: 

)PUT D26 "TEST" 

Get file from disk (drive | slot 6) named TEST: 

)GET "TEST" 

Note: The default is drive 1 slot 6. 

Assemble file CRTDVR and generate a listing: 

JASSM "CRTDVR" LIST 

Output directory for default drive then for drive 2, slot 6: 


DC "CATALOG" 
)DC "CATALOG, D2.S6" 


Delete binary file TEST . EXE: 

)DC "DELETE TEST. EXE" 

Delete source file TEST . ASM: 

)DC "@TEST.ASM" 

Note: actually deletes TEST.ASM and TEST. ASM* 
Clear the text file: 

) CLEAR 

Direct output to printer: 


)TO PRINTER - with non-standard interface or standard interface using PARL . OUT 
driver (included) ) 
DC "PR#n" - with standard interface at slot n not using PARL . OUT 


Direct output thru UART at 300 baud with 10 pad bits: 
)TO SERIAL 1 10 
Assign device associated with UART as input (keyboard) and output (with 2 pad bits): 


)TI TERMINAL 2 
S -user types S on serial keyboard then types RETURN. 


Find all occurrences of the text LDA: 

)FIND /LDA/ 

Replace all occurrences of "LDA FA" with "LDA *FA" between lines 1000 and 2000: 
JEDIT /LDA FA/LDA *FA/ 1000 2000 
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#16 


#17 


#18 


#19 


#20 


#21 


#22 


#23 


#24 


#25 


Provide for 15 characters per label: 

) FORMAT SET 15 

Output all fixed (external) labels: 

)LABELS FIXED 

Renumber the text file beginning at line number 100 and incrementing by 5: 
NUMBER 100 5 

Move lines 100 thru 200 to after line 9000: 

MOVE 9000 100 200 

Print lines 900 thru 976: 

)PRINT 900 976 

Reallocate the text file to $400 thru $1FFC: 

SET $400 $1FFC 

Go to BASIC: 

) BASIC or CTRL+B 

Note: return via CALL 20480 (cold start) or CALL 20483 (warm start) 
Go to Machine Language Monitor: 

) BREAK or CTRL+C 

Note: return via 5000G (cold start) or 5003G (warm start) 

Run assembly program at symbolic label BOX: 

)RUN BOX 


Run assembly program at hex address $A03: 
RUN $A03 


b. ASSM Examples 


#1 


#2 


#3 


Begin assembly at $1000 and store object code: 


.BA $1000 
.OS 


Begin assembly at $1000 but store object code at $4000: 


.BA $1000 
.MC $4000 
.OS 


Define the CRT output routine: 
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#4 


#5 


#6 


#7 


#8 


#9 


#10 


#11 


#12 


COUT .DE $FDED 

Assign an internal work location in zero page: 
WORK .DI $0 

Allocate 6 bytes of storage: 

TABLE .DS 6 


Define label EOI as a mask with bit 6 set and show its use in an AND statement: 


EOI .DE %01000000 
AND #E0I 


Load the low address part of the label VALUES in register X and high part in register Y: 


LDX #L,VALUES 
LDY #H,VALUES 


Give an example of the . BY pseudo op: 
.BY ‘ALARM CONDITION ON MOTOR 1' $0D $0A 
Store the address of the internal label TABLE and the external label COUT: 


-SI TABLE 
»SE COUT 


Define the contents of the text file as Macro Global so its macro definitions can be used 
by subsequent files in the assembly: 


.MG 

Note: — This locks the macro definitions in the text buffer. If you get a ! OF error on 
subsequent loads, you should know that you have overflowed the text buffer. 
The solution is to allocate more memory via the ) SET command and then 
reassemble. 


Show example of a very long label: 


MEMORY .TEST.FOR.6502 
JMP MEMORY.TEST.FOR.6502 


Note: — Long labels (greater than that specified via the .) FO command) are allowed if 
defined on a line with no mnemonics. 


Reference the call to the BASCALC Apple routine so the relocating loader will not alter 
the address during loading: 


BASCALC .DE $FBCL 
JSR BASCALC 


JSR $FBC1 
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11. Getting Started with MAE 
Load MAE as follows: 


1) Insert MAE diskette in appropriate disk drive. 
2) Boot the system from the MAE diskette. 

Do if you have Applesoft ROM BASIC: 
3) A menu will be displayed on the screen. 


Select from the menu to execute MAE or the Relocating Loader, or to go to 
BASIC or the Monitor. To get started, select to execute MAE. 


Do if you have Integer ROM BASIC: 


4) The message FILE TYPE MISMATCH will be displayed because the greeting 
program was in Applesoft BASIC. 


(Note: A listing of this menu program is provided in Part 16 which you can 
modify for Integer BASIC if necessary.) 


Simply BRUN the desired program. To get started, type BRUN MAE. EXE 
MAE will respond with: 


C 1979 BY C MOSER 
3000-4FFC 1800-2FFC 7800 
3000 1800 


This displays the default allocations of memory for the text file ($3000-$4FFC), label file 
($1800-$2FFC), and start address of the 256 byte relocatable buffer ($7800). On the next 
line, the current end of the text file and label file are displayed. Since they are initially cleared, 
these are the same as their respective start addresses. You should note that the current end will 
change as you insert/delete data in the text file and label file. The ) SET command can be used to 
display this range again or alter the file boundaries. 


Remember, to exit MAE, issue either the ) BASIC or ) BREAK commands to go to BASIC or to 
Monitor. You may reenter MAE via 5003G (warm start - everything preserved) or 5000G (cold 
start - everything cleared to default state). If you are in BASIC, type CALL 20483 to warm 
start MAE. This is the same as 5003G from the monitor. 


The first thing you should do now is to load the MAE . NOT file via 


GET "MAE.NOT" 
) FORMAT CLEAR _ turn formatting off 


The MAE .NOT file will contain any pertinent information pertaining to MAE that was 
discovered after this manual was printed. Please review the information in this file. 
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Now you should start playing around with MAE by executing its commands and then proceeding 
to entering programs. Try reviewing the commands in Part 3, assembler features in Part 4, and 
then the examples in Part 10. 


We hope you find MAE to be an excellent program development and worthwhile investment. 
Happy Assembling!!! 


12. The MAE Simplified Text Processor (STP) 

The MAE Simplified Text Processor (STP) is a word processor program designed specifically to 
work with the MAE text editor. The STP coexists with the MAE and occupies memory between 
$A00 and $152F. The primary purpose of this word processor was to provide a simplified 
means to process program documentation and for other text processing needs. (This manual was 
produced using the STP.) This simplicity was accomplished with a set of easily remembered 
word processing functions, and usage of an already familiar text editor to enter and edit the raw 
text. 


STP, unlike some word processing programs, can output the formatted text to the screen. This, is 
most useful on 80 column displays and can result in a tremendous savings in time and paper. 


The STP word processor also provides lower case printing capability (for printer only) for Apple 
II systems without lower case hardware modifications. This, of course, assumes that the printer is 
capable of printing lower case characters. The STP automatically converts all alphabetic 
characters to lower case for the printer and then back to upper case for the CRT. Two special 
command characters are used to provide upper case: "]" and "<". These characters are inserted 
in the raw text file but are not printed by either the printer or the CRT when the file is formatted. 
In order to provide a single upper case character at the beginning of a sentence or the first letter 
of a proper name, use the "<" Immediately before typing the character to be capitalized. The "]" 
character is used like a shift-lock key. When the STP first recognizes this special character, the 
lower case conversion is deactivated until another "]" character is encountered. The printer 
driver Included in the MAE (the nonstandard serial driver or the PARL . OUT driver included on 
the MAE disk) is required in order to utilize the "<" and "]" characters to obtain lower case 
characters on the printer. 


If your system has lower case modifications installed, the STP can be configured to handle lower 
case to the Apple screen by inserting three NOPs at $0B3D-$0B3F and at $1485-$1487. 


To instruct the word processor to perform a word processing function, one inserts text macros in 
the text to be formatted. A text macro always begins with a period (.), always begins in column 
1, may be entered as upper or lower case, and may or may not have associated parameters. The 
following are the macros provided by the STP word processor: 


Vertical Spacing (. vSpace Nn) 


This macro is used to provide single, double, triple spacing, etc. for the entire output. 
Enter the macro as shown above with the desired spacing. For example, to request a 
double spaced output, enter .vSpace 2. 
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Temporary Indent (. Sn) 


To Indent n spaces on the next line, use the . SN macro where n = the number of spaces 
to Indent. For example, . $5 will indent the next line 5 spaces from the left. 


Margin Control(.m n p q Pr) 


The margins default to 66 lines per page, left margin begins at column 0, print width = 76 
characters per line, and the number of blank lines between text body and each title and 
footer = 3. 


The parameters in the margin macro are: 


n_ left margin begin position (default = 0) 

number of characters per line (default = 76) 

number of lines per page minus r. Example: if lines 

per page = 66 and the number of blank lines between 

titles and footers = 3, then q = 66-3 = 63. 

r number of blank lines between text body and each 
header and footer. Default = 3 


p 
q 


For example, to specify left margin to begin in column 5, print width of 60, 66 lines/page, 
and 4 spaces between text body and titles and footers, enter .m 5 60 62 4. 


If you enter just .m 5 60, the previously entered values for parameters q and r will be 
assumed. The margin may be changed at any point as desired in the text. The maximum 
value for n is 76. 


Turn off Justification (. nofi11) 


The .nofi11 macro turns off the justification function. This means that the lines will be 
printed without adding spaces to make the margins come out even. Also, lines of text are 
not combined to fill to the specified margins. 


Begin a New Page (. Ff) 
The . ff macro may be entered when one wants the printer to eject to the top of the next 
page. 

Conditional Form Feed (. ff n) 
Perform a form feed if less than n lines remain at the bottom of the page. 

Literal Space (A character) 


Normally, spaces are not processed like other characters. If several spaces are entered 
consecutively, the STP word processor recognizes only one space and deletes the rest. If 
it is desired to force a certain number of spaces in a line for tabular formats, etc., a string 
of caret (A) characters may be inserted into the text but one must be in the shift-lock 
mode. The caret will not be printed when the text is processed but instead a space will be 
printed for each occurrence of the caret. 
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Turn on Justification (. ju) 


The . jU macro may be entered in order to restore justification. . JU is normally used to 
revert back to Justification after using the .nofi11 macro. 


Ragged Right Margin (. rr) 


This macro turns off the addition of spaces in order to make the margins come out even. 
Lines of text are still combined in order to approximate the specified number of 
characters per line. The left margin will be straight but the right margin will be ragged. 


Ragged Left Margin (. 1) 


This macro is the same as the . rr macro except that the right margin is straight and the 
left margin is ragged. 


Skip Next n Lines (. 1n) 


Use this macro to skip a number of lines before printing the next line of text. For 
example, to skip 2 lines and begin printing, enter . 12. If you enter . | by itself, one will 
be assumed. Thus . 1 and . 11 are equivalent and each will result in a movement to the 
next line. 


Center Line of Text(.c text) 


This macro is useful for centering a line of text. For example, to center the phrase STP 
Word Processor, enter .cC STP Word Processor. 


Swap Justification Modes (. Swap) 
This macro is used to switch from . rr mode to . r'] and vice versa. 
Paragraph Specification (.p d 1) and Paragraph Identification (.p) 


Use the .p d r macro to inform the word processor what a paragraph is supposed to 
be: d = number of lines down, and r = number of spaces right for paragraph indent. The 
default is d= 1, andr =5. 


In order to identify a paragraph start in your text, use the . Pp macro with no parameters. 
Paragraph Numbering or Identification (.pi text) 


The best use for this macro is for paragraph numbering. An example for this is ". p14 


1.01". 
Page Title (.t] text) 


A one line title at the top of each page may be entered using this macro. For example, to 
specify the title CONFIDENTIAL, enter .t CONFIDENTIAL. If you want to also 
include a page number, enter . t# CONFIDENTIAL. Note that the # specifies page 
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numbering. If you want just a page number (the default state), enter just . t#. If you want 
neither title nor page number, enter just . t to turn off all titling. 


Page Footers (. foot text) 


A one line footer at the bottom of each page may be specified using this macro. The 
parameters for . foot are the same as for the title. The default is no footers. 


File Linkage (. link filename) 


This macro can link text modules together as a single printable document. An example is 
. link d26 "SECTION14". Simply enter the link macro at the bottom of the file 
immediately before the one you want loaded and processed. Thus the first file would 
have a . link to the second, the second to the third, etc. There is no limit to the number 
of files which can be linked. 


Running Machine Language Programs (. ru $XXXX) 


This macro allows the user to run a machine language program at any point during the 
text formatting process. This is helpful when it is desired to send command strings to the 
printer to change the character set, to perform elongated printing, etc. The machine 
language program issues the command string and performs an RTS back to the MAE. 
The text processing then continues with no indication of the interruption. 


Printing Text ()WC and )WP._) 


Normally )RU $A00 Is used to send STP output to the CRT, and )RU AO3 is used to 
send the output to the printer. The STP also contains an initialization routine at $A06 
which provides two new commands. After the initialization routine is run by typing ) RU 
$A06, the )WP command can be used to send STP output to the printer and ) WC can be 
used to send It to the CRT. 


When the )WP and )WC commands are performed, the . 1 ink macros are ignored unless 
specifically asked for by typing )WP LT. Additionally, the first a pages may be 
suppressed by typing )WP LI nor )WP nN. These options can also be used with the 
)WC command. 


Creating Shape Tables(. Shape nand.set n 1 p) 


The STP Word Processor has provisions for printing text in various shape formats by 
using a table to control the right and left margins. The . shape macro is used to define 
the shape to be used, Shape | is in the form of an 'T' and entered by simply entering the 
command .Shape 1 at the beginning of the text file. 


The .Shape 2 macro may be used to create a user defined shape. In order to define the 
desired shape, . Set macros are used to make entries in the user shape table 
corresponding to the desired shape, the parameters in the .set n 1 p areas follows: 


nN line number for this margin specification 
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1 column for left margin start 
P number of characters to be printed on this line 


For example, .Set 14 5 40 defines line 14 as left margin starts in column 5, and 
there are 40 characters to be printed on this line. 


Normally one would have to enter 66 set macros to complete the user shape table. But it 
should be noted that .Sset O 1 p isa special case. The 0 (which would normally 
represent the line number) indicates that all lines in the file are set to a left margin of 1 
and print width of p. This is useful as you can set all lines in the user shape table to a 
particular margin and then use non 0 values to change certain lines to form the desired 
shape. 


Note: Always enter the .Shape 2 macro before the . Set macros. The reason is that as 
soon as the .Shape 2 macro is encountered, it fills the user shape table to default 
values of left margin = 0, and print width = 40. Thus if you enter . Set macros first, they 
will be overwritten by the .Shape 2 defaults of 0 and 40. 


If .Shape 2 is entered and no shape commands are entered, the margins will default to 
.m 0 40. This is very useful when it is desired to view the formatted output on the 
Apple's 40 column screen. 


Default Conditions 


The following are a number of assumed defaults that exist on initial entry to the word 
processor: 


Justification On 
Shaping Off 
Margins 66 lines/page, 3 blank lines between text body and titles and 


footers, left margin = 0, and print width = 76. 
Vertical Spacing _1 (single spaced output) 


Paragraph 1 line down and 5 space Indent 
Page Title page number but no text 
Page Footer no text or page number 


a. How to Use the STP Word Processor 


1) 


2) 
3) 
4) 


Load the word processor and MAE via: 


BRUN MAE.EXE 
)DC "BLOAD WORDP. EXE" 


Clear format mode via ) FORMAT CLEAR. 

Enter raw text using MAE for editing. Include all necessary text processing macros. 
When you are finished entering the raw text and associated text macros, generate a 
formatted output via: 


)RUN $A00 for output to CRT only 
RUN SAO3 for output to CRT and Printer 
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RUN $A06 to Initialize output commands )WP and )WC. Subsequently, )WP 

sends STP output to the printer, and )WC send It to the CRT. The 
Parallel or Serial Printer Driver in MAE, is required for this mode 
of operation. 

b. Example 

A raw text file named WORDP.. INS is contained on the diskette. Type )GET "WORDP.INS" 

to load this file. Type .) PRINT to examine the raw text with associated macros. Type .) RUN 

$A00 (CRT only) or )RUN $A0Q3 (CRT and non-standard Printer) to execute the word 

processor and output the text in word processor format. Note: If you output this to a 40 column 

Apple, It will not appear neat since the margin was set for 76 characters per line. 


Now compare the raw text printout with its text macros to the formatted output generated by the 
word processor. Examine these two printouts until you are familiar with the function of the STP 
macros. 


13. Special Notes 
a. Converting Eastern House ASSM/TED Files to MAE Files 
1) Use usual procedure to enter MAE. 
2) Use ) SET to allocate the necessary space for file to be converted. 
3) Use ) BR to enter monitor. 
4) Clear text file area as follows. 


*3000:0 (first byte of text file - 00) 
*3001<3000.4FFCM (all bytes - 00) 


Note that this example uses boundaries $3000 - $4FFC. This step should be changed to 
agree with your boundary settings. 


5) Warm start MAE (*5003G) 
6) BLOAD old ASSM/TED file from disk 


DC "BLOAD Snn.file,A$xxxx" (xxxx = current start of text file) 


7) Type )PR / to list last line. 

8) Return to monitor with ) BR. 

9) Move contents of $76E4 and $76E5 to $76DA and $76DB. 
10) Warm start MAE (*5003G). 

11) Save new MAE file using ) PUT command. 


b. Editing Basic Programs with MAE 
Wouldn't it be nice to be able to use the copy, move, search/replace, and auto line numbering 
features of the MAE to edit BASIC programs? Well, it can be done. 


The editor cannot tell the difference between assembly language, text such as you are now 
reading, and BASIC instructions. However, the Apple DOS EXEC command is the thing that 
makes this idea possible. The text can be created with MAE's editor and then saved as a text file 
on the disk. When the program is to be executed, simply type EXEC "textfilename" from 
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BASIC and the program will be loaded from disk and executed. Before running the program in 
this manner, you should type NEW in order to remove any BASIC program currently residing in 
RAM. If this is not done, the text file program will be appended to or overlaid on the existing 
program, depending on the line numbers of the two programs. 


The TEXTOUT . EXE program is used to create the text file when the BASIC program has been 
completed and is still in the MAE text area (the text file boundaries must begin at $3000). You 
just type )DC "BLOAD TEXTOUT.EXE" and then )RU $805. The TEXTOUT. EXE program 
will ask you for a name for the output text file (it must be limited to 20 characters). When the 
name has been entered and followed by a RETURN, the TEXTOUT . EXE program will begin 
loading the text from MAE's text area into a sequential text file on the disk. The line numbers are 
converted from the packed- BCD form (low byte first) used by the MAE, to ASCII and stored 
with the most significant digit stored first. Additionally, leading zeros of the line number are 
deleted. The Instruction is then stored until the end-of-line byte is found (this is determined by 
testing bit 7 for 1). 


After each line is stored, the next line is tested for end-of-file. If the third byte of the line (first 
byte following the line number) is 00, then all data has been saved and the text file can be closed. 
The TEXTOUT . EXE program will then return to the MAE. You may then type ) BA or CTRL+B 
to exit to BASIC in order to test the text file program. 


The text file can be reloaded into the MAE by typing )DC "EXEC filename”. This allows 
for subsequent editing of the source program. 


When the BASIC program is complete and tested, it can be saved as a regular BASIC program or 
RUN once it has been EXECed into RAM from BASIC. 


c. Converting MAE Files To and From Other Assemblers 

The TEXTOUT program can also be used to transfer MAE assembler files to another assembler 
which requires text-file source code. In order to transfer source files from another assembler to 
the MAE, the text file created by the other assembler can be EXECed into the MAE as previously 
described. If the other assembler does not store line numbers in the source file, the other 
assembler must be used to initiate auto line numbering in the MAE. This is done by making the 
first line of the file "auto 10" and the second line "0" (the quotes are for emphasizing the line, 
they should not actually be typed in the text file). 


d. Miscellaneous Notes 

e When entering source modules (without . EN), you can perform a short test on the 
module by assembling the module while in the text file and watching for the !07 error. If 
other error messages occur, you have errors in the module. This short test is not a 
complete test but does check to insure you have lined up the fields properly, not entered 
duplicate labels within the module, or entered illegal mnemonics or addressing modes. 

e MAE's internal software UART resides in locations $7303-$7406. 

e An 80 character/line output device should be used when printing an assembly listing In 
order to provide a neat printout without fold-over to the next line. 
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e If you are going to use MAE and BASIC together, alter HIMEM ($0073, $0074) so 
BASIC will not clobber MAE, or its text or label files. 

e Use quality diskettes like Scotch or Dysan. A few dollars saved on a cheap diskette is not 
worth the risk of lost data. 

e We recommend that a naming convention for your files be established. We use the 
following extensions: 


name.CTL Control File 

name.MxxX Module referenced in Control File 

name.ASM Source file without . CT 

name.EXE = Executable object file 

name.REL — Relocatable object file 

name.MAC File containing all Macros 

name.LIB Library of symbols 

name.MLIB Library of Macros 

name.DOC Program Documentation 

name.INS — User Instructions 

name.NOT Program Notes 

name.BAS — BASIC Program 

name.DAT — BASIC Data File 

e The MAE can be configured for use with 80-column cards such as the Sup'R'term card. If 

you have one of these cards, make the following patches to the MAE and then resave It 
(BSAVE MAE,A$5000,L$2C90) 

(1) Insert NOPs ($EA) in MAE locations $7A4B-$7A4D. 

(2) At $7A55 insert :20 60 7C (20 80 7c? or 20 90 7C?) 

(3) At $7C90 insert :A9 8C 20 ED FD AY 98 20 ED FD 60 This provides 
the HOME command for Sup'R'tem but may also be used for other 80-column 
cards. 

(4) At $68BE insert :4E 


Note: You may also want to make the changes to the STP as shown in Part 12 so that the 80- 
column/lower case card can be used for text processing. 


14. ASSM/TED Users Goup 

An ASSM/TED Users Group has been formed by James Strasma for the exchange of programs 
and unique modules. Most of the information in this exchange is oriented to PET MAE but 
should soon contain some Apple MAE compatible software. The cost per diskette is also 
minimal but the Information Is extremely useful. For more details, contact: 


James Strasma 

c/o Grace U.M.C. 
120 West King Street 
Decatur, 111. 62521 
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15. How to Configure for Printer 

If you are using an Apple parallel or Centronics or Tymac parallel printer card, you will want to 
change the printer driver internal to the MAE. This can be done very easily by typing ) AS 
"PARL.OUT" . This file is included on the MAE disk and can be modified to use the interface 
card in any slot (see comments in PARL . OUT file). If you are using the card in slot number 1, no 
modification is required. In that case, all you need to do is type )DC "BLOAD 

PARL.OUT. EXE". In either case, you should resave the MAE when the printer driver has been 
loaded or assembled. This is done by typing )DC "BSAVE MAE,A$5000,L$2C90". When 
this change has been made, the printer can be activated by typing )TO P and deactivated by 
typing )TO A. Also, )RU $A0Q3, or )WP can then be used to send STP output to the printer. 


If you are using a non-standard printer Interface (i.e. one which does not work via PR#N), you 
may either use the provided non-standard printer driver or substitute your own. In any case to 
turn on the non-standard printer, type )TO PRINTER. To turn off, type )TO APPLE. 


The non-standard printer driver provided within MAE is designed to be utilized with an RS232 
parallel to serial interface card such as the one provided by Electronic Systems Co., and the 
Heathkit H14 printer. This printer driver is set up to operate with the serial interface card in slot 
0. Just in case this is not compatible with your system, we have provided a listing of the printer 
driver which you can use reconfigure for your requirements. The listing is provided in Part 16. 
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16. Example Listings 
A listing of the Applesoft menu program, non-standard printer driver, and an example UART 
program in MAE's syntax is contained in this section. 


The UART program is a software UART driver contained on the supplied diskette under files: 
UART.CTL, UART.MO1, UART.MO2, and UART.MO3. 


The UART driver program has three entry points: 


1. SET. BAUD Optional entry used to automatically measure user terminal baud rate. 
2. UART . OUT Output character in RCA). 
3. UART.IN Input character and return in RCA). 


Note: The UART program is free to use by MAE purchasers for any non-commercial purpose. 
For commercial use, we only request that you briefly write describing the use of the VART 
program. We request no monetary payment or any other remuneration. 


a. UART Program 
0010 ~CT ;DESIGNATE AS CONTROL FILE 
0020 
0030 .CE ;CONTINUE IF ERRORS 
0040 
0050 .-BA $2000 
0060 
0070 ; +4++++++ DEFINITIONS +4+4+++++ 
0080 
0090 PIA.PORT .DE $6841 ;PLA DATA PORT 
0100 PIA.DIR .DE $6843 ;PIA DIRECTION PORT 
0110 
0120 MSK.IN .DE %01000000 ; INPUT IS ON BIT 6 
0130 MSK.OUT .DE %10000000 ;OUTPUT IS ON BIT 7 
0140 
0150 
0160 ;UART CONTROL PARAMETERS: 
0170 ;-------------------------------------------- 
0180 
2000- 0190 NO.PADBITS .DS 1 ;NO. OF PAD BITS ON CR LF 
0200 
2001- 0210 BIT.TIME .DS 1 ;BAUD RATE CODE (0-7) 
0220 ; poo-- ---- ---- ----- 
0230 ; : 
0240 ; 
0250 ; 
0260 ; 
0270 
0280 
0290 
0300 .FI D16 "UART.MOL" ;SET BAUD AND TABLE 


WNRrR OO 

ou ue dl 
w 
(oe) 
[o) 

ou ued 
a 
for) 
(o>) 
(o>) 


DELAYS 


O7F6 432D-4B23 UART .MO1 
0010 


0020 ; +++++ SET BAUD RATE 4++4+++ 
0030 
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2002- 08 0040 SET.BAUD PHP ;SAVE PSR 


2003- 78 0050 SEI ;CLEAR INTERRUPTS 
2004- AD 43 E8 0060 LDA PIA.DIR ; INITIALIZE PORT ON LOGON 
2007- 29 BF 0070 AND #$FF-MSK.IN : * 
2009- 09 80 0080 ORA #MSK . OUT : 
2008- 8D 43 E8 0090 STA PIA.DIR : 
0100 
200E- 20 47 20 0110 LP1 JSR GET.BIT 
2011- D8& FB 0120 BNE LP1 ;BR. IF ALREADY SPACING 
2013- AD 41 E8 0130 LP2 LDA PIA.PORT 
2016- 29 40 0140 AND #MSK.IN 
2018- FO F9 0150 BEQ LP2 >BR. IF MARKING 
201A- AO 00 0160 LDY #00 ;CLEAR FOR DELAY FACTOR 
201c- AD 41 E8 0170 LP3 LDA PIA.PORT GET BIT 
201F- 29 40 0180 AND #MSK.IN ; * 
2021- FO 07 0190 BEQ GOT.COUNT 
2023- CO FF 0200 CPY #$FF 
2025- FO F5 0210 BEQ LP3 
2027- C8 0220 INY 
2028- D8& F2 0230 SKP.FF BNE LP3 
0240 
202A- 98 0250 GOT.COUNT TYA ;MOVE COUNT TO R(A) 
202B- AO 00 0260 LDY #00 
2820- 09 3F 20 0270 LP.FI CMP TBLBAUD, Y 
2030- BO 03 0280 BCS GOTBAUD 
2032- C8 0290 INY 
2033- DO F8 0300 BNE LP.FI 
2035- 8C 01 20 0310 GOTBAUD STY BIT. TIME ;STORE BAUD RATE CODE 
2038- A2 OC 0320 LDX #12 ;WAIT UNTIL ALL BITS HAVE 
203A- 20 BE 20 0330 JSR PAD.DELX 
203D- 28 0340 PLP 
203E- 60 0350 RTS 
0360 
0370 
203F- FF 0380 TBLBAUD ~BY 255 ; >= 110 
2040- 93 0390 .BY 147 ; >= 300 
2041- 4A 0400 .BY 74 ; >= 600 
2042- 25 0410 .BY 37 ; >= 1200 
2043- 12 0420 .BY 18 ; >= 2400 
2044- OA 0430 .BY 10 ; >= 4800 
2045- 07 0440 .BY 7 ; >= 7200 
2046- 00 0450 .BY 0 ; >= 9600 
0460 
0470 
2047- AD 41 E8 0480 GET.BIT LDA PIA.PORT >GET KEYBOARD INPUT 
204A- 29 40 0490 AND #MSK.IN ; * 
204c- 60 0500 RTS 
0510 
204D- AD 01 20 0520 DELO.5 LDA BIT. TIME 
2050- 18 0530 CLC 
2051- D8 0540 CLD 
2052- 69 08 0550 ADC #08 
2054- A8 0560 TAY 
2055- 4c 5B 20 0570 JMP ENO.5 
0580 
2058- AC 01 20 0590 DLYFULL LDY BIT. TIME 
205B- B9 66 20 0600 ENO.5 LDA UD.TBL1.Y 
205E- FO 16 0610 BEQ NOT.THIS 
2060- A8 0620 TAY 
2061- 88 0630 LOOPDEL1 DEY 
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2062- 
2064- 
2065- 


2066- 
2067- 
2868- 
2069- 
206A- 
206B- 
206C- 
206D- 


206E- 
206F- 
2078- 
2071- 
2072- 
2073- 
2074- 
2075- 


2076- 
2079- 
207A- 
207D- 
2080- 
2081- 
2084- 
2087- 
2088- 
2089- 
208B- 


208C- 
208D- 
208E- 
208F- 
2092- 


2094- 
2095- 
2096- 


0343 


2097- 
2098- 
2099- 
209C- 
209D- 


DO FD 0640 


EA 0650 
60 0660 
0670 
0680 
00 0690 
00 0700 
00 0710 
9A 0720 
47 0730 
1D 0740 
OF 0750 
08 0760 
0770 
0780 
00 0790 
00 0880 
00 0810 
48 0820 
1F 0830 
0A 0840 
03 0850 
01 0860 
0870 
B9 8C 20 0880 
A8 0890 
48 48 48 0900 
48 48 48 
48 
68 68 68 0910 
68 68 68 
68 
88 0920 
DO EF 0930 
60 0940 
0950 
0960 
A7 0970 
3C 0980 
1E 0990 


00 00 00 1000 
00 00 


1010 
1020 
53 1030 
1E 1040 
OE 1050 
0310 
432D-4670 
0010 
0020 
0030 
08 0040 
78 0050 
20 9E 20 0060 
28 0070 
60 0080 
0090 


BNE LOOPDEL1 


NOP 
RTS 
3 ---DELAY=5X+19 
UD.TBL1 -BY 00 ;DELAY FULL FOR 110 BAUD 
-BY 00 ;DELAY FULL FOR 300 * 
-BY 00 ;DELAY FULL FOR 600 
-BY 154 ;DELAY FULL FOR 1200 
-BY 71 ;DELAY FULL FOR 2400 
-BY 29 ;DELAY FULL FOR 4800 
-BY 15 ;DELAY FULL FOR 7200 
.BY 08 ;DELAY FULL FOR 9600 


-BY 00 ;DELAY 0.5 FOR 118 BAUD 
-BY 00 ;DELAY 0.5 FOR 300 * 
-BY 00 ;DELAY 0.5 FOR 600 

-BY 72 ;DELAY 0.5 FOR 1200 

BY 31 ;DELAY 0.5 FOR 2400 

.BY 10 ;DELAY 0.5 FOR 4800 

.BY 03 ;DELAY 0.5 FOR 7200 

-BY 01 ;DELAY 0.5 FOR 9600 


NOT.THIS LDA UD.TBL2,Y 
TAY 
LOOPDEL2 .BY $48 $48 $48 $48 $48 $48 $48 


-BY $68 $68 $68 $68 $68 $68 $68 


DEY 
BNE LOOPDEL2 
RTS 


3 ---DELAY=54X+22 

UD.TBL2 -BY 167 ;DELAY FULL FOR 110 BAUD 
-BY 60 ;DELAY FULL FOR 300 * 
-BY 30 ;DELAY FULL FOR 600 
.BY 00 00 00 00 00 


3 ---DELAY=54X+31 


BY 83 ;DELAY 0.5 FOR 110 BAUD 
.BY 30 ;DELAY 0.5 FOR 300 * 
.BY 14 ;DELAY 0.5 FOR 600 

-FI D16 "UART.MO2" ;UART OUTPUT DRIVER 


UART .MO2 


; +++++ UART OUTPUT +++++ 


UART.OUT PHP 
SEI 
JSR UART.OUT1 
PLP ;RESTORE PSR AND RETURN 
RTS 
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209E- 
209F- 
20A1- 
20A2- 
20A4- 
20A5- 
20A8- 
20AB- 
20AC- 
20AD- 
20AE- 
20AF- 
20B1- 
20B2- 
20B3- 
20B5- 
20B7- 
20B9- 
20BB- 
20BD- 


20BE- 
20BF- 
20c1- 


20C4- 
20C5- 
20C8- 
20CA- 
20CD- 
20CE- 
20D0- 
20D1- 


20D2- 
20D5- 
20D7- 
20D9- 
20DB- 
20DE- 


0248 


20DF- 
20E0- 
20E1- 
20E3- 
20E4- 
20E7- 


20E9- 
20EC- 


48 0100 
49 FF 0110 
48 0120 
A2 OB 0130 
38 0140 


20 D2 20 0150 
20 58 20 0160 


68 0170 
4A 0180 
48 0190 
CA 0200 
DO F4 0210 
68 0220 
68 0230 


29 7F 0240 
c9 OD 0250 


FO 8B 0260 
c9 OA 0270 
FO 07 0280 
68 0290 

0300 
48 0310 
EO 00 0320 
4c c8& 20 0330 

0340 
48 0350 
AE 00 20 0360 
FO 06 0370 
20 58 20 0380 
CA 0390 
DO FA 0400 
68 0410 
60 0420 

0430 


AD 41 £8 0440 
29 7F 0450 
90 02 0460 
09 80 0470 


80 41 E8 0480 
60 0490 
0500 
0510 
0320 
432D-4575 
0010 
0020 
0030 
08 0040 
78 0050 
AY 00 0060 
48 0070 


20 47 20 0080 


DO FB 0090 
0100 
20 47 28 0110 
FO FB 0120 
0130 


UART .OUTL 


LP.UOUT 


PAD .DELX 


PAD .DEL 
PAD .DELEN 
LP. PDEL 


EX.DEL 


BIT .OUT 


SKP. BOUT 


.FI D16 "UART.MO3" 


UART .MO3 


PHA >SAVE CHAR. 
EOR #$FF ; INVERT 

PHA 

LDX #11 ;11 BITS: 1 STOP, 8 DATA, 
SEC 

JSR BIT.OUT ;BIT TO PORT 
JSR DLYFULL ;DELAY FULL BIT TIME 
PLA ;RESTORE R(A) 
LSR A >NEXT BIT 

PHA ;AND SAVE 

DEX 

BNE LP.UOUT ; LOOP 

PLA ;REMOVE JUNK 
PLA >RESTORE CHAR. 
AND #$7F >CLEAR BIT 7 
CMP #$0D ;CR 

BEQ PAD.DEL 

CMP #$0A >LF 

BEQ PAD.DEL 

RTS 

PHA 

CPx #00 

JMP PAD.DELEN 

PHA ; PRESERVE 

LDX NO.PADBITS ;GET # OF PAD BITS 
BEQ EX.DEL >SKIP IF ZERO 
JSR DLYFULL ; DELAY 

DEX 

BNE LP.PDEL ; LOOP 

PLA >RESTORE 

RTS 

LDA PIA.PORT ;PUT BIT 


AND #$FF-MSK.OUT 
BCC SKP.BOUT 

ORA #MSK.OUT 

STA PIA. PORT 

RTS 


;UART INPUT DRIVER 


; +++++ UART INPUT +++++ 


UART.IN 


LP.UI1L 
BNE 


LP.UI2 


PHP 
SEI 

LDA —- #00 ;CLEAR CHAR. 

PHA ; * 

JSR GET.BIT ;GET BIT 

LP.UI1 ;LOOP UNTIL NO BIT 

JSR GET.BIT ;GET BIT 

BEQ LP.UI2 ;LOOP UNTIL START BIT 
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20EE- 20 4D 20 0140 


20F1- 20 47 20 0150 
20F4- 38 0160 
20F5- DO 01 0170 
20F7- 18 0180 
20F8- 68 0190 
20F9- 6A 0200 
20FA- BO 07 0210 
20FC- 48 0220 
20FD- 20 58 20 0230 
2100- 18 0240 
2101- 90 EE 0250 
2103- 49 FF 0260 
2105- 29 7F 0270 
2107- 28 0280 
2108- 60 0290 

0330 

0340 

0350 

0360 


END OF MAE PASS! 


LABEL FILE: - 


BIT.OUT =20D2 
DLYFULL =2058 
END.PGM =2109 
GOT.COUNT =202A 
LOOPDEL2 =207A 
LP.UI1 =20E4 
LP.UOUT =20A5 
LP3 =201C 
NO.PADBITS =2000 
PAD.DELEN =20C8 
P1A.PORT =E841 
SKP.FF =2028 
UART.IN =20DF 
UD.TBL1 =2066 


//88B8 , 2189, 21if 
) 


LP.UI3 


SKP.UI1 


DONE .UI 


END. PGM EN 


BIT.TIME =2001 
DONE.UI =2103 
EX.DEL =20D0 
GOTBAUD =2035 
LP.F1 =202D 
LP.UI2 =20E9 
LP1 =200E 
MSK.IN =0040 
NOT.THIS =2076 
PAD.DELX =20BE 
SET.BAUD =2002 
SKP.UI1 =20F8 
UART.OUT =2097 
UD.TBL2 =208C 


DELO.5 ;DELAY UNTIL MIDDLE OF START B 
GET.BIT GET BIT 
>ASSUME SPACE 
SKP.UI1 
>NO IT IS MARK 
A ;ROTATE RIGHT INTO CARRY 
DONE.UI 
DLYFULL ;DELAY UNTIL MIDDLE OF NEXT 
LP.U13 ;LOOP FOR NEXT BIT 
#$FF > INVERT 
#$7F ;CLEAR BIT 7 
;RESTORE PSR AND RETURN 
DEL8.5 =204D 
EN8.5 =205B 


GET.BIT =2047 
LOOPDEL1 =2061 
LP.PDEL =20CA 
LP.UI3 =20F1 


LP2 =2013 


MSK.OUT =0080 
PAD.DEL =20C4 
PIA.DIR =E843 
SKP.BOUT =20DB 
TBLBAUD =203F 
IWRT.OUT1 =209E 
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b. MAE Supplied Nonstandard Printer Driver 
(Designed for Electronic Systems Serial Interface and Heath H14 Printer) 


3920 ; 
3930 ; 
7BAD- 48 3940 PR.OUT PHA >SAVE THE CHAR. 
76AE- AD 80 CO 3950 WAITL LDA $c080 >CHECK RS-232 INPT FOR BUSY 
7BB1- 29 03 3960 AND #$03 ;MASK OUT HI NIBBLE 
7BB3- C9 01 3970 CMP #$01 ;($11=NOT BUSY) 
7BB5- DO F7 3980 BNE WAITL 
7BB7- AD 81 CO 3990 WAIT2 LDA $c081 >CHECK UART STATUS 
7BBA- 6A 4000 ROR A (BIT 7) 
7BBB- 90 FA 4010 BCC WAIT2 
7BBD- 68 4020 PLA >RESTORE CHAR. 
7BBE- 8D 82 Co 4030 STA $C082 >SEND IT TO RS-232 OUTPUT 
7BC1- 60 4040 EXIT RTS 


c. MAE Menu Listing (Applesoft BASIC) 

20 HOME :D$ = CHR$ (84): PRINT TABC 6)"MACRO ASSEMBLER/EDITOR (MAE)": PRINT 
TABC 12)"APPLE II VERSION" 

30 PRINT : PRINT TABC 13)"COPYRIGHT 1980" 

40 PRINT TABC 9)"EASTERN HOUSE SOFTWARE": PRINT : PRINT : PRINT : PRINT 

: PRINT "ENTER CODE FOR DESIRED FUNCTION": PRINT 

50 PRINT " A = ASSEMBLER/EDITOR (MAE)": PRINT " R = RELOCATING LOADER": PRINT 
" Ww = MAE AND WORD PROCESSOR": PRINT " B = BASIC": PRINT " M = MONITOR" 

60 PRINT : PRINT : PRINT : INPUT A$: IF A$ = 'A™ THEN PRINT D$'BRUN MAE.EXE 
"+ END 

"R" THEN PRINT D$"BRUN RELOC.EXE": END 

"B" THEN END 

100 IF A$ = "M" THEN CALL - 151 

102 IF A$ < > "W" THEN 20 

105 PRINT D$"BLOAD MAE.EXE": FOR X = 1 TO 1000: NEXT X 

117 PRINT D$"BLOAD WORDP.EXE": CALL 20480 
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17. Error Codes 
Error Description 
Code 
1B .EN in non .CT file when .CT file exists. 


1A . EN missing in . CT designated file. 
19 Found .FI in non .CT file. 


18 

17 Checksum error on disk load. 
16 

15 Syntax error in ) ED command. 
14 


13 Multiple . CT assignment. 

12 Command syntax error or out of range error. 

11 Missing parameter in ) NU command. 

10 Overflow in line # renumbering. Caution: You should properly renumber the text file for 
proper command operation. 

OF Overflow in text file - line not inserted. 

OE Overflow in label file - label not inserted. 

OD MAE expected hex characters, found none. 

OC Illegal character in label. 

OB Unimplemented addressing mode. 

OA Error in or no operand. 

09 Found illegal character in decimal string. 

08 Undefined label (may be illegal label). 

07 .EN pseudo op missing. 

06 Duplicate label. 

05 Label missing in .DE or .DI pseudo op. 

04 BA or .MC operand undefined. 

03 Illegal pseudo op. 

02 Illegal mnemonic or undefined macro. 

O01 Branch out of range. 

00 Not a zero page address. 

ED Error in command input. 

2F Overflow in file sequence count (2**16 max.) 

2E Overflow In number of macros (2**16 max.) 


2B .ME without associated .MD 
2A —_Non-symbolic label in SET pseudo op. 
29 Illegal nested definition. 


27 Macro definition overlaps file boundary. 

26 Duplicate macro definition. 

25 Quantity parameters mismatch or illegal characters. 
24 Too many nested macros (32 max.) 

23 Macro definition not complete at .EN 

22 Conditional suppress set at EN 

21 = Macro in expand state at .EN 

20 Attempted expansion before definition. 
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